XScript 매뉴얼 · Chapter 33

DATE 객체 — 날짜·시각 처리

스크립트에서 키워드 DATE 로 접근하는 날짜·시각 유틸. 내부 표현은 .NET 의 Ticks(long) — DateTime 보다 가볍고 비교·연산이 단순합니다.

형태	의미
`long` (Ticks)	1 tick = 100 ns. `DateTime(0001-01-01)` 부터의 누적값.
`"yyyy-MM-dd HH:mm:ss"`	사람이 읽는 표준 포맷

현재 시각 한 줄 — long now = DATE.GetNow();

현재 시각

long nowLocal = DATE.GetNow();      // 로컬 타임존 기준 Ticks
long nowUtc   = DATE.GetUtcNow();   // UTC 기준 Ticks
 
Log($"now local : {DATE.ConvertDateTimeString(nowLocal)}");
Log($"now utc   : {DATE.ConvertDateTimeString(nowUtc)}");

문자열 ↔ Ticks 변환

// Ticks → 문자열
string d  = DATE.ConvertDateString(DATE.GetNow());                   // "2026-05-06"
string dt = DATE.ConvertDateTimeString(DATE.GetNow());                // "2026-05-06 09:31:02"
string dt2 = DATE.ConvertDateTimeString(DATE.GetNow(), "HH:mm:ss");  // 사용자 포맷
 
// 문자열 → Ticks
long t1 = DATE.ConvertDateTimeLong("2026-05-06 09:30:00");
long t2 = DATE.ConvertUtcDateTimeLong("2026-05-06T00:30:00Z");
 
// 안전 파싱 — 실패 시 false
long t3;
if( DATE.TryParseDateTime("2026-13-99", t3) == false )
{
    LogError("invalid date input");
}

포맷 문자: yyyy MM dd HH mm ss fff (대소문자 주의 — MM 월 / mm 분)

로컬 ↔ UTC 변환

long local = DATE.GetNow();
long utc   = DATE.ConvertLocalToUtc(local);
 
long backToLocal = DATE.ConvertUtcToLocal(utc);

DB 에 저장할 때는 UTC, 화면 표시는 Local — 두 변환만 기억하면 됩니다.

Encode / Decode

// 연·월·일·시·분·초·ms 로 만들기
long t = DATE.EncodeDate(2026, 5, 6);
long u = DATE.EncodeDateTime(2026, 5, 6, 9, 30, 0, 0);
 
// 분해
int year, month, day;
DATE.DecodeDate(t, year, month, day);
 
int yy, mm, dd, hh, mi, ss, ms;
DATE.DecodeDateTime(u, yy, mm, dd, hh, mi, ss, ms);

DecodeDate / DecodeDateTime 은 out 파라미터로 변수에 직접 채워줍니다.

두 시각의 차이 (Between)

long start = DATE.EncodeDateTime(2026, 5, 1, 9, 0, 0, 0);
long end   = DATE.GetNow();
 
int years   = DATE.YearsBetween(end, start);
int months  = DATE.MonthsBetween(end, start);
int weeks   = DATE.WeeksBetween(end, start);
int days    = DATE.DaysBetween(end, start);
long hours  = DATE.HoursBetween(end, start);
long mins   = DATE.MinutesBetween(end, start);
long secs   = DATE.SecondsBetween(end, start);
long mss    = DATE.MilliSecondsBetween(end, start);
 
Log($"elapsed : {days}d {hours % 24}h {mins % 60}m");

인수 순서는 무관 — 내부적으로 절대값으로 계산합니다.

시간 가감 (Increment*)

long now = DATE.GetNow();
 
long oneYearLater  = DATE.IncrementYears(now, 1);
long threeMonths   = DATE.IncrementMonths(now, 3);
long tomorrow      = DATE.IncrementDays(now, 1);
long inOneHour     = DATE.IncrementHours(now, 1);
long inFiveMinutes = DATE.IncrementMinutes(now, 5);
long inThirtySec   = DATE.IncrementSeconds(now, 30);
long inOneSecond   = DATE.IncrementMilliseconds(now, 1000);
 
// 음수 → 과거 방향
long yesterday     = DATE.IncrementDays(now, -1);

자주 쓰는 패턴

작업 경과시간 표시

long workStart;
 
FUNCTION OnStart()
{
    workStart = DATE.GetNow();
}
 
FUNCTION OnTick()
{
    long now = DATE.GetNow();
    int sec = (int)DATE.SecondsBetween(now, workStart);
    Data::ElapsedText = $"{sec / 60}:{sec % 60:00}";
}

상한 시각까지 대기

long deadline = DATE.IncrementSeconds(DATE.GetNow(), 30);
 
while( DATE.GetNow() < deadline )
{
    if( SYS.IsHomeDone() ) return true;
    Sleep(50);
}
return false;     // timeout

일자별 폴더 생성

string today = DATE.ConvertDateString(DATE.GetNow());        // "2026-05-06"
string folder = $"D:/Logs/{today}";
SYS.CreateFolder(folder);

함수 한눈 요약

함수	반환	의미
`GetNow()` / `GetUtcNow()`	long	현재 시각 (로컬 / UTC)
`ConvertDateString(t)`	string	`"yyyy-MM-dd"`
`ConvertDateTimeString(t)` / `(t, fmt)`	string	표준 / 사용자 포맷
`ConvertDateTimeLong(s)`	long	문자열 → Ticks
`ConvertUtcDateTimeLong(s)`	long	UTC 가정 후 변환
`TryParseDateTime(s, ref t)`	bool	안전 파싱
`ConvertLocalToUtc(t)` / `ConvertUtcToLocal(t)`	long	TZ 변환
`EncodeDate / EncodeDateTime`	long	숫자 → Ticks
`DecodeDate / DecodeDateTime`	void	Ticks → out 변수들
`YearsBetween` / `Months` / `Weeks` / `Days` / `Hours` / `Minutes` / `Seconds` / `MilliSeconds`	int / long	두 시각 차이
`IncrementYears` / `Months` / `Days` / `Hours` / `Minutes` / `Seconds` / `Milliseconds`	long	가감