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、画面表示はローカル — この 2 つの変換を覚えておけば十分。

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 パラメータで変数に直接埋めます。

2 時刻の差(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	2 時刻の差
`IncrementYears / Months / Days / Hours / Minutes / Seconds / Milliseconds`	long	加減(負値で減)