@pingleware/metatrader4-oanda/datetime.js

Metatrader 4 to OANDA v2.0 REST API proxy

"use strict"

const {systime} = require('./account');

var MqlDateTime = { 
    year: 2022,        // Year 
    mon: 9,           // Month 
    day: 19,           // Day 
    hour: 0,          // Hour 
    min: 0,           // Minutes 
    sec: 0,           // Seconds 
    day_of_week: 1,    // Day of week (0-Sunday, 1-Monday, ... ,6-Saturday) 
    day_of_year: 0     // Day number of the year (January 1st is assigned the number value of zero) 
};

/**
 * TimeCurrent
 * Returns the last known server time (time of the last quote receipt) in the datetime format
*/ 
function TimeCurrent(){
    return {status: 'success', current: new Date().toISOString(), function: 'TimeCurrent'};
}
/**
 * TimeLocal
 * Returns the local computer time in datetime format
*/ 
function TimeLocal(){
    return {status: 'success', local: new Date().toLocaleTimeString(), function: 'TimeLocal'};
}
/**
 * TimeGMT
 * Returns GMT in datetime format with the Daylight Saving Time by local time of the computer, where the client terminal is running
*/ 
function TimeGMT(){
    return {status: 'success', gmt_utc: new Date().toUTCString(), function: 'TimeGMT'};
}
/**
 * TimeDaylightSavings
 * Returns the sign of Daylight Saving Time switch
*/ 
function TimeDaylightSavings(){
    let now = new Date();
    let jan = new Date(now.getFullYear(), 0, 1).getTimezoneOffset();
    let jul = new Date(now.getFullYear(), 6, 1).getTimezoneOffset();
    return { status: 'success', daylight_savings: (Math.max(jan, jul) !== now.getTimezoneOffset()), function: 'TimeDaylightSavings'};    
}
/**
 * TimeGMTOffset
 * Returns the current difference between GMT time and the local computer time in seconds, taking into account DST switch
*/ 
function TimeGMTOffset(){
    return { status: 'success', gmt_offset: new Date().getTimezoneOffset(), function: 'TimeGMTOffset'};
}
/**
 * TimeToStruct
 * Converts a datetime value into a variable of MqlDateTime structure type
*/ 
function TimeToStruct(time_value){
    var time = new Date(time_value);
    MqlDateTime.year = time.getFullYear();
    MqlDateTime.mon = time.getMonth();
    MqlDateTime.day = time.getDate();
    MqlDateTime.hour = time.getHours();
    MqlDateTime.min = time.getMinutes();
    MqlDateTime.sec = time.getSeconds();
    MqlDateTime.day_of_week = time.getDay();

    var start = new Date(time.getFullYear(), 0, 0);
    var diff = time - start;
    var oneDay = 1000 * 60 * 60 * 24;
    MqlDateTime.day_of_year = Math.floor(diff / oneDay);

    return {status: 'success', mqldatetime: MqlDateTime, function: 'TimeToStruct'};
}
/**
 * StructToTime
 * Converts a variable of MqlDateTime structure type into a datetime value
*/ 
function StructToTime(datetime){
    return {status: 'success', datetimee: new Date(datetime.year,datetime.mon,datetime.day,datetime.hour,datetime.min,datetime.sec).getTime(), function: 'StructToTime'};
}
/**
 * Day
 * Returns the current day of the month, i.e., the day of month of the last known server time
*/ 
function Day(){
    return {status: 'success', day: new Date().getDate(), function: 'Day'};
}
/**
 * DayOfWeek
 * Returns the current zero-based day of the week of the last known server time
*/ 
function DayOfWeek(){
    return {status: 'success', dayofweek: new Date().getDay(), function: 'DayOfWeek'};
}
/**
 * DayOfYear
 * Returns the current day of the year i.e., the day of year of the last known server time
*/ 
function DayOfYear(){
    var now = new Date();
    var start = new Date(now.getFullYear(), 0, 0);
    var diff = now - start;
    var oneDay = 1000 * 60 * 60 * 24;
    return {status: 'success', dayofyear: Math.floor(diff / oneDay), function: 'DayOfYear'};
}
/**
 * Hour
 * Returns the hour of the last known server time by the moment of the program start
*/ 
function Hour(){
    return {status: 'success', hour: new Date().getHours(), function: 'Hour'};
}
/**
 * Minute
 * Returns the current minute of the last known server time by the moment of the program start
*/ 
function Minute(){
    return {status: 'success', minute: new Date().getMinutes(), function: 'Minute'};
}
/**
 * Month
 * Returns the current month as number, i.e., the number of month of the last known server time
*/ 
function Month(){
    return {status: 'success', month: new Date().getDate(), function: 'Month'};
}
/**
 * Seconds
 * Returns the amount of seconds elapsed from the beginning of the current minute of the last known server time by the moment of the program start
*/ 
function Seconds(){
    var now = new Date();
    return {status: 'success', seconds: new Date(now.getTime() - systime.start).getSeconds(), function: 'Seconds'};
}
/**
 * TimeDay
 * Returns the day of month of the specified date
*/ 
function TimeDay(time){
    var _time = new Date(time);
    return {status: 'success', day: _time.getMonth(), function: 'TimeDay'};
}
/**
 * TimeDayOfWeek
 * Returns the zero-based day of week of the specified date
*/ 
function TimeDayOfWeek(time){
    var _time = new Date(time);
    return {status: 'success', day: _time.getDay(), function: 'TimeDayOfWeek'};
}
/**
 * TimeDayOfYear
 * Returns the day of year of the specified date
*/ 
function TimeDayOfYear(time){
    var now = new Date(time);
    var start = new Date(now.getFullYear(), 0, 0);
    var diff = now - start;
    var oneDay = 1000 * 60 * 60 * 24;
    return {status: 'success', day: Math.floor(diff / oneDay), function: 'TimeDayOfYear'};
}
/**
 * TimeHour
 * Returns the hour of the specified time
*/ 
function TimeHour(time){
    var _time = new Date(time);
    return {status: 'success', hour: _time.getHours(), function: 'TimeHour'};
}
/**
 * TimeMinute
 * Returns the minute of the specified time
*/ 
function TimeMinute(time){
    var _time = new Date(time);
    return {status: 'success', minute: _time.getMinutes(), function: 'TimeMinute'};
}
/**
 * TimeMonth
 * Returns the month number of the specified time
*/ 
function TimeMonth(time){
    var _time = new Date(time);
    return {status: 'success', month: _time.getDate(), function: 'TimeMonth'};
}
/**
 * TimeSeconds
 * Returns the amount of seconds elapsed from the beginning of the minute of the specified time
*/ 
function TimeSeconds(time){
    var _time = new Date(time);
    return {status: 'success', seconds: _time.getSeconds(), function: 'TimeSeconds'};
}
/**
 * TimeYear
 * Returns year of the specified date
*/ 
function TimeYear(time){
    var _time = new Date(time);
    return {status: 'success', year: _time.getFullYear(), function: 'TimeYear'};
}
/**
 * Year
 * Returns the current year, i.e., the year of the last known server time
*/
function Year(){
    return {status: 'success', year: new Date().getFullYear(), function: 'Year'};
}


module.exports = {
    MqlDateTime,
    TimeCurrent,
    TimeLocal,
    TimeGMT,
    TimeDaylightSavings,
    TimeGMTOffset,
    TimeToStruct,
    StructToTime,
    Day,
    DayOfWeek,
    DayOfYear,
    Hour,
    Minute,
    Month,
    Seconds,
    TimeDay,
    TimeDayOfWeek,
    TimeDayOfYear,
    TimeHour,
    TimeMinute,
    TimeMonth,
    TimeSeconds,
    TimeYear,
    Year 
};