Time Shield Library 2.0.0
C++ library for working with time
Loading...
Searching...
No Matches
time_formatting.mqh
Go to the documentation of this file.
1//+------------------------------------------------------------------+
2//| time_formatting.mqh |
3//| Time Shield - MQL5 Time Formatting |
4//| Copyright 2025, NewYaroslav |
5//| https://github.com/LimiNode/time-shield-cpp |
6//+------------------------------------------------------------------+
7#ifndef TIME_SHIELD_MQL5_HEADER_TIME_FORMATTING_MQH_INCLUDED
8#define TIME_SHIELD_MQL5_HEADER_TIME_FORMATTING_MQH_INCLUDED
9
17
18#property copyright "Copyright 2025, NewYaroslav"
19#property link "https://github.com/LimiNode/time-shield-cpp"
20#property strict
21
22#include "enums.mqh"
23#include "date_time_struct.mqh"
24#include "time_zone_struct.mqh"
25#include "time_conversions.mqh"
26
27
28namespace time_shield {
29
32
37 string pad_int(int value, int width) {
38 string s = IntegerToString(value);
39 while(StringLen(s) < width)
40 s = "0" + s;
41 return s;
42 }
43
44 //----------------------------------------------------------------------
45 // Custom formatting
46 //----------------------------------------------------------------------
47
59 void process_format_impl(
60 const char last_char,
61 int repeat_count,
62 long ts,
63 int utc_offset,
64 const DateTimeStruct &dt,
65 string &result) {
66 switch(last_char) {
67 case 'a':
68 if(repeat_count<=1)
69 result += time_shield::to_str(day_of_week(dt.year, dt.mon, dt.day), time_shield::FormatType::SHORT_NAME);
70 break;
71 case 'A':
72 if(repeat_count<=1)
73 result += time_shield::to_str(day_of_week(dt.year, dt.mon, dt.day), time_shield::FormatType::FULL_NAME);
74 break;
75 case 'I':
76 if(repeat_count==1)
77 result += pad_int(hour24_to_12(dt.hour),2);
78 break;
79 case 'H':
80 if(repeat_count<=2)
81 result += pad_int(dt.hour,2);
82 break;
83 case 'h':
84 if(repeat_count==2)
85 result += pad_int(dt.hour,2);
86 else
87 result += to_str((Month)dt.mon, SHORT_NAME);
88 break;
89 case 'b':
90 if(repeat_count<=1)
91 result += to_str((Month)dt.mon, SHORT_NAME);
92 break;
93 case 'B':
94 if(repeat_count<=1)
95 result += to_str((Month)dt.mon, FULL_NAME);
96 break;
97 case 'c':
98 if(repeat_count<=1) {
99 result += to_str(day_of_week(dt.year, dt.mon, dt.day), SHORT_NAME)+" ";
100 result += to_str((Month)dt.mon, SHORT_NAME)+" ";
101 result += StringFormat("%2d ", dt.day);
102 result += StringFormat("%02d:%02d:%02d ", dt.hour, dt.min, dt.sec);
103 result += IntegerToString(dt.year);
104 }
105 break;
106 case 'C':
107 if(repeat_count<=1)
108 result += IntegerToString(dt.year/100);
109 break;
110 case 'd':
111 if(repeat_count<2)
112 result += pad_int(dt.day,2);
113 break;
114 case 'D':
115 if(repeat_count==1)
116 result += StringFormat("%02d/%02d/%02d", dt.mon, dt.day, (int)(dt.year%100));
117 else if(repeat_count==2)
118 result += pad_int(dt.day,2);
119 break;
120 case 'e':
121 if(repeat_count==1)
122 result += StringFormat("%2d", dt.day);
123 break;
124 case 'F':
125 if(repeat_count==1)
126 result += StringFormat("%lld-%02d-%02d", dt.year, dt.mon, dt.day);
127 break;
128 case 'j':
129 if(repeat_count==1)
130 result += pad_int(day_of_year(ts),3);
131 break;
132 case 'k':
133 if(repeat_count==1)
134 result += StringFormat("%2d", dt.hour);
135 break;
136 case 'l':
137 if(repeat_count==1)
138 result += StringFormat("%2d", hour24_to_12(dt.hour));
139 break;
140 case 'm':
141 if(repeat_count==1)
142 result += pad_int(dt.mon,2);
143 else if(repeat_count==2)
144 result += pad_int(dt.min,2);
145 break;
146 case 'M':
147 if(repeat_count==1)
148 result += pad_int(dt.min,2);
149 else if(repeat_count==2)
150 result += pad_int(dt.mon,2);
151 else if(repeat_count==3)
152 result += to_str((Month)dt.mon, UPPERCASE_NAME);
153 break;
154 case 'n':
155 result += "\n";
156 break;
157 case 'p':
158 result += dt.hour<12?"AM":"PM";
159 break;
160 case 'P':
161 result += dt.hour<12?"am":"pm";
162 break;
163 case 'r':
164 if(repeat_count==1)
165 result += StringFormat("%02d:%02d:%02d %s", hour24_to_12(dt.hour), dt.min, dt.sec, dt.hour<12?"AM":"PM");
166 break;
167 case 'R':
168 if(repeat_count==1)
169 result += StringFormat("%02d:%02d", dt.hour, dt.min);
170 break;
171 case 's':
172 if(repeat_count==1)
173 result += IntegerToString(ts);
174 else if(repeat_count==3)
175 result += IntegerToString(dt.ms);
176 break;
177 case 'S':
178 if(repeat_count<=2)
179 result += pad_int(dt.sec,2);
180 if(repeat_count==3)
181 result += IntegerToString(dt.ms);
182 break;
183 case 't':
184 if(repeat_count<=1)
185 result += "\t";
186 break;
187 case 'T':
188 if(repeat_count==1)
189 result += StringFormat("%02d:%02d:%02d", dt.hour, dt.min, dt.sec);
190 break;
191 case 'u':
192 if(repeat_count==1) {
193 int dw = day_of_week(dt.year, dt.mon, dt.day);
194 if(dw==0) dw=7;
195 result += IntegerToString(dw);
196 }
197 break;
198 case 'w':
199 if(repeat_count==1)
200 result += IntegerToString(day_of_week(dt.year, dt.mon, dt.day));
201 else if(repeat_count==3)
202 result += to_str(day_of_week(dt.year, dt.mon, dt.day), SHORT_NAME);
203 break;
204 case 'W':
205 if(repeat_count==3)
206 result += to_str(day_of_week(dt.year, dt.mon, dt.day), UPPERCASE_NAME);
207 break;
208 case 'y':
209 if(repeat_count==1)
210 result += IntegerToString(dt.year%100);
211 break;
212 case 'Y':
213 if(repeat_count==1)
214 result += IntegerToString(dt.year);
215 break;
216 case 'z':
217 if(repeat_count==1) {
218 TimeZoneStruct tz = to_time_zone_struct(utc_offset);
219 string sign = tz.is_positive?"+":"-";
220 result += sign+pad_int(tz.hour,2)+pad_int(tz.min,2);
221 }
222 break;
223 case 'Z':
224 result += "UTC";
225 break;
226 }
227 }
228
238 string to_string(string format_str, long timestamp, int utc_offset=0) {
239 string result="";
240 if(StringLen(format_str)==0) return result;
241 DateTimeStruct dt = to_date_time(timestamp);
242 bool is_command=false;
243 int repeat_count=0;
244 char last_char = (char)format_str[0];
245 if(last_char!='%') result+=CharToString(last_char);
246 for(int i=0;i<StringLen(format_str);++i) {
247 char current_char = (char)format_str[i];
248 if(!is_command) {
249 if(current_char=='%') {
250 ++repeat_count;
251 if(repeat_count==2) {
252 result += "%";
253 repeat_count=0;
254 }
255 continue;
256 }
257 if(!repeat_count) {
258 result += CharToString(current_char);
259 continue;
260 }
261 last_char=current_char;
262 is_command=true;
263 continue;
264 }
265 if(last_char==current_char) {
266 ++repeat_count;
267 continue;
268 }
269 process_format_impl(last_char, repeat_count, timestamp, utc_offset, dt, result);
270 repeat_count=0;
271 is_command=false;
272 --i;
273 }
274 if(is_command)
275 process_format_impl(last_char, repeat_count, timestamp, utc_offset, dt, result);
276 return result;
277 }
278
283 string to_str(string format_str, long timestamp, int utc_offset=0) {
284 return to_string(format_str, timestamp, utc_offset);
285 }
286
295 string to_string_ms(string format_str, long timestamp_ms, int utc_offset=0) {
296 string result="";
297 if(StringLen(format_str)==0) return result;
298 DateTimeStruct dt = to_date_time_ms(timestamp_ms);
299 bool is_command=false;
300 int repeat_count=0;
301 char last_char = (char)format_str[0];
302 if(last_char!='%') result+=CharToString(last_char);
303 for(int i=0;i<StringLen(format_str);++i) {
304 char current_char = (char)format_str[i];
305 if(!is_command) {
306 if(current_char=='%') {
307 ++repeat_count;
308 if(repeat_count==2) {
309 result += "%";
310 repeat_count=0;
311 }
312 continue;
313 }
314 if(!repeat_count) {
315 result += CharToString(current_char);
316 continue;
317 }
318 last_char=current_char;
319 is_command=true;
320 continue;
321 }
322 if(last_char==current_char) {
323 ++repeat_count;
324 continue;
325 }
326 process_format_impl(last_char, repeat_count, ms_to_sec(timestamp_ms), utc_offset, dt, result);
327 repeat_count=0;
328 is_command=false;
329 --i;
330 }
331 if(is_command)
332 process_format_impl(last_char, repeat_count, ms_to_sec(timestamp_ms), utc_offset, dt, result);
333 return result;
334 }
335
340 string to_str_ms(string format_str, long timestamp_ms, int utc_offset=0) {
341 return to_string_ms(format_str, timestamp_ms, utc_offset);
342 }
343
344 //----------------------------------------------------------------------
345 // ISO8601 helpers
346 //----------------------------------------------------------------------
347
351 string to_iso8601(long ts) {
352 DateTimeStruct dt = to_date_time(ts);
353 return StringFormat("%lld-%02d-%02dT%02d:%02d:%02d", dt.year, dt.mon, dt.day, dt.hour, dt.min, dt.sec);
354 }
355
359 string to_iso8601_ms(long ts_ms) {
360 DateTimeStruct dt = to_date_time_ms(ts_ms);
361 return StringFormat("%lld-%02d-%02dT%02d:%02d:%02d.%03d", dt.year, dt.mon, dt.day, dt.hour, dt.min, dt.sec, dt.ms);
362 }
363
367 string to_iso8601_date(long ts) {
368 DateTimeStruct dt = to_date_time(ts);
369 return StringFormat("%lld-%02d-%02d", dt.year, dt.mon, dt.day);
370 }
371
375 string to_iso8601_time(long ts) {
376 DateTimeStruct dt = to_date_time(ts);
377 return StringFormat("%02d:%02d:%02d", dt.hour, dt.min, dt.sec);
378 }
379
383 string to_iso8601_time_ms(long ts_ms) {
384 DateTimeStruct dt = to_date_time_ms(ts_ms);
385 return StringFormat("%02d:%02d:%02d.%03d", dt.hour, dt.min, dt.sec, dt.ms);
386 }
387
391 string to_iso8601_utc(long ts) {
392 return to_iso8601(ts)+"Z";
393 }
394
398 string to_iso8601_utc_ms(long ts_ms) {
399 return to_iso8601_ms(ts_ms)+"Z";
400 }
401
406 string to_iso8601(long ts, int utc_offset) {
407 TimeZoneStruct tz = to_time_zone(utc_offset);
408 string sign = tz.is_positive?"+":"-";
409 return StringFormat("%s%s%.2d:%.2d", to_iso8601(ts), sign, tz.hour, tz.min);
410 }
411
416 string to_iso8601_ms(long ts_ms, int utc_offset) {
417 TimeZoneStruct tz = to_time_zone(utc_offset);
418 string sign = tz.is_positive?"+":"-";
419 return StringFormat("%s%s%.2d:%.2d", to_iso8601_ms(ts_ms), sign, tz.hour, tz.min);
420 }
421
422 //----------------------------------------------------------------------
423 // MQL5 specific helpers
424 //----------------------------------------------------------------------
425
429 string to_mql5_date_time(long ts) {
430 DateTimeStruct dt = to_date_time(ts);
431 return StringFormat("%lld.%02d.%02d %02d:%02d:%02d", dt.year, dt.mon, dt.day, dt.hour, dt.min, dt.sec);
432 }
433
437 string to_mql5_date(long ts) {
438 DateTimeStruct dt = to_date_time(ts);
439 return StringFormat("%lld.%02d.%02d", dt.year, dt.mon, dt.day);
440 }
441
445 string to_mql5_time(long ts) {
446 DateTimeStruct dt = to_date_time(ts);
447 return StringFormat("%02d:%02d:%02d", dt.hour, dt.min, dt.sec);
448 }
449
452 string to_mql5_full(long ts) { return to_mql5_date_time(ts); }
453
457 string to_windows_filename(long ts) {
458 DateTimeStruct dt = to_date_time(ts);
459 return StringFormat("%lld-%02d-%02d_%02d-%02d-%02d", dt.year, dt.mon, dt.day, dt.hour, dt.min, dt.sec);
460 }
461
465 string to_windows_filename_ms(long ts_ms) {
466 DateTimeStruct dt = to_date_time_ms(ts_ms);
467 return StringFormat("%lld-%02d-%02d_%02d-%02d-%02d-%03d", dt.year, dt.mon, dt.day, dt.hour, dt.min, dt.sec, dt.ms);
468 }
469
473 string to_human_readable(long ts) {
474 DateTimeStruct dt = to_date_time(ts);
475 return StringFormat("%lld-%02d-%02d %02d:%02d:%02d", dt.year, dt.mon, dt.day, dt.hour, dt.min, dt.sec);
476 }
477
481 string to_human_readable_ms(long ts_ms) {
482 DateTimeStruct dt = to_date_time_ms(ts_ms);
483 return StringFormat("%lld-%02d-%02d %02d:%02d:%02d.%03d", dt.year, dt.mon, dt.day, dt.hour, dt.min, dt.sec, dt.ms);
484 }
485
487
488}; // namespace time_shield
489
490#endif // TIME_SHIELD_MQL5_HEADER_TIME_FORMATTING_MQH_INCLUDED
date_time_struct.mqh
Header for date and time structure and related functions (MQL5).
enums.mqh
Header file with enumerations for weekdays, months, and other time-related categories.
time_shield::SHORT_NAME
@ SHORT_NAME
Short name.
Definition enums.hpp:21
time_shield::FULL_NAME
@ FULL_NAME
Full name.
Definition enums.hpp:22
time_shield::UPPERCASE_NAME
@ UPPERCASE_NAME
Uppercase short name.
Definition enums.hpp:20
time_shield::ms_to_sec
TIME_SHIELD_CONSTEXPR T1 ms_to_sec(T2 ts_ms) noexcept
Converts a timestamp from milliseconds to seconds.
Definition time_unit_conversions.hpp:180
time_shield::hour24_to_12
TIME_SHIELD_CONSTEXPR T hour24_to_12(T hour) noexcept
Converts a 24-hour format hour to a 12-hour format.
Definition time_unit_conversions.hpp:466
time_shield::to_time_zone
T to_time_zone(tz_t offset)
Converts an integer to a time zone structure.
Definition time_zone_offset_conversions.hpp:22
time_shield::day_of_week
TIME_SHIELD_CONSTEXPR T1 day_of_week(year_t year, int month, int day)
Alias for day_of_week_date.
Definition time_conversion_aliases.hpp:1798
time_shield::to_str
const std::string & to_str(Weekday value, FormatType format=UPPERCASE_NAME)
Converts a Weekday enum value to a string.
Definition enums.hpp:70
time_shield::Month
Month
Definition enums.hpp:93
time_shield::to_iso8601_ms
const std::string to_iso8601_ms(ts_ms_t ts_ms)
Converts a timestamp in milliseconds to an ISO8601 string.
Definition time_formatting.hpp:731
time_shield::to_mql5_date_time
const std::string to_mql5_date_time(ts_t ts)
Converts a timestamp to a string in MQL5 date and time format.
Definition time_formatting.hpp:874
time_shield::to_iso8601_time
const std::string to_iso8601_time(T ts)
Converts a timestamp to an ISO8601 time string.
Definition time_formatting.hpp:634
time_shield::process_format_impl
void process_format_impl(char last_char, size_t repeat_count, ts_t ts, tz_t utc_offset, const DateTimeStruct &dt, std::string &result)
Definition time_formatting.hpp:23
time_shield::to_windows_filename
const std::string to_windows_filename(ts_t ts)
Converts a timestamp in seconds to a Windows-compatible filename format.
Definition time_formatting.hpp:931
time_shield::to_iso8601_date
const std::string to_iso8601_date(T ts)
Converts a timestamp to an ISO8601 date string.
Definition time_formatting.hpp:613
time_shield::to_mql5_date
const std::string to_mql5_date(ts_t ts)
Converts a timestamp to a string in MQL5 date format.
Definition time_formatting.hpp:902
time_shield::to_mql5_full
const std::string to_mql5_full(ts_t ts)
Alias for to_mql5_date_time_str function.
Definition time_formatting.hpp:892
time_shield::to_iso8601_time_ms
string to_iso8601_time_ms(long ts_ms)
Convert millisecond timestamp to ISO8601 time string.
Definition time_formatting.mqh:383
time_shield::to_mql5_time
const std::string to_mql5_time(ts_t ts)
Converts a timestamp to a string in MQL5 time format.
Definition time_formatting.hpp:921
time_shield::to_str_ms
const std::string to_str_ms(const std::string &format_str, T timestamp, tz_t utc_offset=0)
Alias for to_string function.
Definition time_formatting.hpp:560
time_shield::to_human_readable
std::string to_human_readable(ts_t ts)
Converts a timestamp in seconds to a human-readable format.
Definition time_formatting.hpp:970
time_shield::to_iso8601_utc_ms
const std::string to_iso8601_utc_ms(ts_ms_t ts_ms)
Converts a timestamp in milliseconds to an ISO8601 string in UTC format.
Definition time_formatting.hpp:708
time_shield::to_iso8601
const std::string to_iso8601(T ts)
Converts a timestamp to an ISO8601 string.
Definition time_formatting.hpp:575
time_shield::to_human_readable_ms
std::string to_human_readable_ms(ts_ms_t ts)
Converts a timestamp in milliseconds to a human-readable format.
Definition time_formatting.hpp:989
time_shield::to_string_ms
const std::string to_string_ms(const std::string &format_str, T timestamp, tz_t utc_offset=0)
Convert timestamp in milliseconds to string with custom format.
Definition time_formatting.hpp:508
time_shield::to_windows_filename_ms
const std::string to_windows_filename_ms(ts_ms_t ts)
Converts a timestamp in milliseconds to a Windows-compatible filename format.
Definition time_formatting.hpp:950
time_shield::to_iso8601_utc
const std::string to_iso8601_utc(T ts)
Converts a timestamp to an ISO8601 string in UTC format.
Definition time_formatting.hpp:672
time_shield::pad_int
string pad_int(int value, int width)
Internal helper to pad integer with leading zeros.
Definition time_formatting.mqh:37
time_shield::to_time_zone_struct
TimeZoneStruct to_time_zone_struct(tz_t offset)
Converts an integer to a TimeZoneStruct.
Definition time_zone_struct.hpp:47
time_shield::to_string
std::string to_string(const TimeZoneStruct &tz)
Alias for time_zone_struct_to_string function.
Definition time_zone_struct.hpp:80
time_shield::to_date_time_ms
T to_date_time_ms(ts_ms_t ts)
Converts a timestamp in milliseconds to a date-time structure with milliseconds.
Definition date_time_conversions.hpp:186
time_shield::day_of_year
T day_of_year(ts_t ts=time_shield::ts())
Get the day of the year.
Definition date_time_conversions.hpp:885
time_shield::to_date_time
T1 to_date_time(T2 ts)
Converts a timestamp to a date-time structure.
Definition date_time_conversions.hpp:153
time_shield::ts
ts_t ts() noexcept
Get the current UTC timestamp in seconds.
Definition time_utils.hpp:213
time_shield::timestamp
ts_t timestamp() noexcept
Get the current UTC timestamp in seconds.
Definition time_utils.hpp:221
time_shield::ts_ms
ts_ms_t ts_ms() noexcept
Get the current UTC timestamp in milliseconds.
Definition time_utils.hpp:245
time_shield::timestamp_ms
ts_ms_t timestamp_ms() noexcept
Get the current UTC timestamp in milliseconds.
Definition time_utils.hpp:253
time_shield
Main namespace for the Time Shield library.
time_shield::DateTimeStruct
Structure to represent date and time.
Definition date_time_struct.mqh:26
time_shield::DateTimeStruct::ms
int ms
Millisecond component of time (0-999)
Definition date_time_struct.hpp:24
time_shield::DateTimeStruct::hour
int hour
Hour component of time (0-23)
Definition date_time_struct.hpp:21
time_shield::DateTimeStruct::year
int64_t year
Year component of the date.
Definition date_time_struct.hpp:18
time_shield::DateTimeStruct::day
int day
Day component of the date (1-31).
Definition date_time_struct.hpp:20
time_shield::DateTimeStruct::min
int min
Minute component of time (0-59)
Definition date_time_struct.hpp:22
time_shield::DateTimeStruct::mon
int mon
Month component of the date (1-12).
Definition date_time_struct.hpp:19
time_shield::DateTimeStruct::sec
int sec
Second component of time (0-59)
Definition date_time_struct.hpp:23
time_shield::TimeZoneStruct
Structure to represent time zone information.
Definition time_zone_struct.mqh:27
time_shield::TimeZoneStruct::hour
int hour
Hour component of time (0-23)
Definition time_zone_struct.hpp:23
time_shield::TimeZoneStruct::min
int min
Minute component of time (0-59)
Definition time_zone_struct.hpp:24
time_shield::TimeZoneStruct::is_positive
bool is_positive
True if the time zone offset is positive, false if negative.
Definition time_zone_struct.hpp:25
time_conversions.mqh
Header with helper functions for converting between different time representations in MQL5.
time_zone_struct.mqh
Header for time zone structure and related functions (MQL5).