High-Performance Time Functions (TimeUtils) - MetaTrader 5용 라이브러리

함수 이름은 자명해야 하며, 특정 함수에 대한 간단한 설명은 TimeUtils.mqh 파일에서 찾을 수 있습니다.

//+==================================================================+
//| 구성 요소에서 날짜 시간 만들기|
//+==================================================================+
datetime CreateDateTime(
   const int year,           // 년도
   const int mon,            // 월
   const int day,            // 일
   const int hour = 0,       // 시간
   const int min = 0,        // 분
   const int sec = 0         // 초
   )
datetime CreateDateTime(MqlDateTime&  dt_struct);  // StructToTime()의 빠른 대안

//+==================================================================+
//| 컴포넌트에 날짜 시간 나누기|
//+==================================================================+
bool TimeToStructFast(
   datetime      dt,         // 변환할 날짜 값
   MqlDateTime&  dt_struct   // 값 채택을 위한 구조
   )

//+==================================================================+
//| 날짜 시간의 구성 요소를 추출합니다: 일요일, yyyy.mm.dd hh:mm:ss |
//| Get() 단위|
//+==================================================================+
int GetSecond(datetime t)
int GetMinute(datetime t)
int GetHour(datetime t)
int GetDay(datetime t)
int GetMonth(datetime t)
int GetYear(datetime t)

//+==================================================================+
//| Day() 숫자|
//+==================================================================+
int DayOfWeek(datetime t)
int DayOfYear(datetime t)
int DayIndex(datetime t)

//+==================================================================+
//| 주() 숫자|
//+==================================================================+
int WeekOfMonth(const datetime t, bool StartsOnMonday = false)
int WeekOfYear(const datetime t, bool StartsOnMonday = false)
int WeekIndex(datetime t, bool StartsOnMonday = false)

//+==================================================================+
//| StartOf() 단위|
//+==================================================================+
datetime StartOfMinute(datetime t)
datetime StartOfHour(datetime t)
datetime StartOfDay(datetime t)
datetime StartOfWeek(datetime t, bool StartsOnMonday = false)
datetime StartOfMonth(datetime t)
datetime StartOfYear(datetime t)

//+==================================================================+
//| EndOf() 단위|
//+==================================================================+
datetime EndOfMinute(datetime t)
datetime EndOfHour(datetime t)
datetime EndOfDay(datetime t)
datetime EndOfWeek(datetime t, bool StartsOnMonday = false)
datetime EndOfMonth(datetime t)
datetime EndOfYear(datetime t)

//+==================================================================+
//| SecsElapsedOf() 단위|
//+==================================================================+
int SecsElapsedOfMinute(datetime t)
int SecsElapsedOfHour(datetime t)
int SecsElapsedOfDay(datetime t)
int SecsElapsedOfWeek(datetime t, bool StartsOnMonday = false)
int SecsElapsedOfMonth(datetime t)
int SecsElapsedOfYear(datetime t)

//+==================================================================+
//| RoundTo() / Nearest() 단위|
//+==================================================================+
datetime RoundToMinute(datetime t)
datetime RoundToHour(datetime t)
datetime RoundToDay(datetime t)
datetime RoundToWeek(datetime t, bool StartsOnMonday = false)

//+==================================================================+
//| CeilTo() / Next() 단위|
//+==================================================================+
datetime CeilToMinute(datetime t)
datetime CeilToHour(datetime t)
datetime CeilToDay(datetime t)
datetime CeilToWeek(datetime t, bool StartsOnMonday = false)

//+==================================================================+
//| Next() 평일|
//+==================================================================+
datetime NextWeekday(datetime t, ENUM_DAY_OF_WEEK weekday = SUNDAY)
datetime NextSunday(datetime t)
datetime NextMonday(datetime t)
datetime NextTuesday(datetime t)
datetime NextWednesday(datetime t)
datetime NextThursday(datetime t)
datetime NextFriday(datetime t)
datetime NextSaturday(datetime t)

//+==================================================================+
//| 이전() 평일|
//+==================================================================+
datetime PreviousWeekday(datetime t, ENUM_DAY_OF_WEEK weekday = SUNDAY)
datetime PreviousSunday(datetime t)
datetime PreviousMonday(datetime t)
datetime PreviousTuesday(datetime t)
datetime PreviousWednesday(datetime t)
datetime PreviousThursday(datetime t)
datetime PreviousFriday(datetime t)
datetime PreviousSaturday(datetime t)

//+==================================================================+
//| Nth() 해당 월의 요일|
//+==================================================================+
datetime FirstWeekdayOfTheMonth(datetime t, ENUM_DAY_OF_WEEK weekday = SUNDAY)
datetime LastWeekdayOfTheMonth(datetime t, ENUM_DAY_OF_WEEK weekday = SUNDAY)
datetime NthWeekdayOfTheMonth(datetime t, int Nth, ENUM_DAY_OF_WEEK weekday = SUNDAY)

//+==================================================================+
//| Add() 단위|
//+==================================================================+
datetime AddSeconds(datetime t, int amount)
datetime AddMinutes(datetime t, int amount)
datetime AddHours(datetime t, int amount)
datetime AddDays(datetime t, int amount)
datetime AddBusinessDays(datetime t, int amount)
datetime AddWeeks(datetime t, int amount)
datetime AddMonths(datetime t, int amount)
datetime AddYears(datetime t, int amount)

//+==================================================================+
//| Sub() 단위|
//+==================================================================+
datetime SubSeconds(datetime t, int amount)
datetime SubMinutes(datetime t, int amount)
datetime SubHours(datetime t, int amount)
datetime SubDays(datetime t, int amount)
datetime SubBusinessDays(datetime t, int amount)
datetime SubWeeks(datetime t, int amount)
datetime SubMonths(datetime t, int amount)
datetime SubYears(datetime t, int amount)

//+==================================================================+
//| DifferenceIn() 단위|
//+==================================================================+
int DifferenceInCalendarDays(datetime beginTime, datetime endTime)
int DifferenceInBusinessDays(datetime beginTime, datetime endTime)
int DifferenceInCalendarWeeks(datetime beginTime, datetime endTime, bool StartsOnMonday = false)
int DifferenceInCalendarMonths(datetime beginTime, datetime endTime)

//+==================================================================+
//| IsSame() 단위|
//+==================================================================+
bool IsSameMinute(datetime t1, datetime t2)
bool IsSameHour(datetime t1, datetime t2)
bool IsSameDay(datetime t1, datetime t2)
bool IsSameWeek(datetime t1, datetime t2, bool StartsOnMonday = false)
bool IsSameMonth(datetime t1, datetime t2)
bool IsSameYear(datetime t1, datetime t2)

//+==================================================================+
//| IsCurrent() 단위|
//+==================================================================+
bool IsCurrentMinute(datetime t)
bool IsCurrentHour(datetime t)
bool IsCurrentWeek(datetime t, bool StartsOnMonday = false)
bool IsCurrentMonth(datetime t)
bool IsCurrentYear(datetime t)
bool IsToday(datetime t)
bool IsTomorrow(datetime t)
bool IsYesterday(datetime t)

//+==================================================================+
//| 기타|
//+==================================================================+
bool IsLeapYear(int year)
int  DaysInMonth(int year, int month)
datetime GetNthWeekdayInYearMonth(iYear, iMonth, Nth, weekday = SUNDAY)
datetime GetNthSundayInYearMonth(iYear, iMonth, Nth)

//+==================================================================+
//| 시간을 문자열로 포맷|
//+==================================================================+
string t2s(datetime t, const int mode = TIME_DATE | TIME_MINUTES)
string SecondsToString(int seconds)
string TimeFormat(datetime t, string format = "YYYY.MM.DD hh:mm")

사용 가능한 모든 시간 형식 목록:

//+------------------------------------------------------------------+
//| 전달된 토큰 문자열에 따라 형식이 지정된 시간을 가져옵니다. |
//| 사용 가능한 모든 형식 목록:|
//| 포맷 출력 설명|
//| ------ ---------------- ------------------------------------- |
//| YY 18두 자리 연도 |
//| 2018년 네 자리 숫자 연도|
//| M 1-121부터 시작하는 월 |
//| MM 01-12 월, 2자리 |
//| MMM 1월~12월 약칭 월 이름, 3글자 |
//| MMMM 1월~12월 전체 월 이름|
//| D 1-31월의 요일 |
//| DD 01-31월의 요일, 2자리 |
//| DDD 일-토 요일의 짧은 이름 |
//| DDDD 일요일-토요일 요일 이름 |
//| h 0-23 시간|
//| hh-23 시간, 2자리 |
//| H 1-12시간, 12시간 시계 |
//| HH 01-12 시간, 12시간 시계, 2자리 | |
//| m 0-59 분|
//| mm 00-59 분, 2자리 |
//| s 0-59 두 번째|
//| ss 00-59 두 번째, 2자리 |
//| 오전 오후|
//| 오전 오후|
//+------------------------------------------------------------------+
//| 샘플 형식:|
//| "YYYY.MM.DD hh:mm" // "2024.12.08 22:05"(기본값) |
//| "DDD, YYYY.MM.DD hh:mm:ss" // "Sun, 2024.12.08 22:05:21" | "Sun, 2024.12.08 22:05:21
//| "D MMMM YYYY, HH:mm a" // "2024년 12월 8일, 오후 10시 5분" |
//| "dd/mm/yyyy" // "08/12/2024"|
//+------------------------------------------------------------------+
string TimeFormat(const datetime t, const string format = "YYYY.MM.DD hh:mm");

2024.12.03 - v.1.10 : 초기 릴리스.

2024.12.05 - v.1.15: 영업일 및 해당 월의 N번째() 요일에 대한 함수가 추가되었습니다. DaysInMonth() 함수의 계산을 최적화했습니다.

2024.12.09 - v.1.20 : 전달된 토큰 문자열에 따라 시간 형식을 지정하는 TimeFormat() 함수를 추가했습니다.

2024.12.09-v.1.25 : TimeToStructFast() 함수의 계산을 최적화했습니다.

2024.12.10-v.1.30 : TimeFormat(), StartOfYear() 및 EndOfYear() 함수가 최적화되었습니다. 일부 함수에 대한 설명이 업데이트되었습니다.

2024.12.15 - v.1.35 : GetNthWeekdayInYearMonth() 함수를 최적화했습니다.

2024.12.18 - v.1.40 : IsCurrentXXX(), IsToday(), IsTomorrow() 및 IsYesterday() 함수를 추가했습니다.

2024.12.19 - v.1.45 : AddMonths() 및 GetNthWeekdayInYearMonth() 함수를 최적화했습니다.

2024.12.20-v.1.50 : 코드 정리가 추가되었습니다.

2024.12.21-v.1.55: AddMonths()의 계산 간소화: 월과 연도를 조정하는 복잡한 로직을 더 간단한 총 월 계산으로 대체했습니다.