API Date

Date

日期与时间值

Date and time value

脚本 API 目录

Script API Directory

概述

Overview

Date 包装 .NET 日期时间。字符串解析使用固定的、不受机器区域影响的格式，例如 yyyy-MM-dd、yyyy-MM-dd HH:mm:ss、yyyy-MM-dd HH:mm:ss.fff、yyyy-MM-dd HH:mm:ss fff 和 yyyy-MM-ddTHH:mm:ss.fff。如果宿主配置了 Runtime.DateTimeFormat，构造器和 Date.parse 会优先尝试该格式；需要当前时间时使用 Date.now() 或 Date.utcNow()。

Date wraps .NET date/time values. String parsing uses fixed, machine-culture-independent formats such as yyyy-MM-dd, yyyy-MM-dd HH:mm:ss, yyyy-MM-dd HH:mm:ss.fff, yyyy-MM-dd HH:mm:ss fff, and yyyy-MM-ddTHH:mm:ss.fff. When the host configures Runtime.DateTimeFormat, the constructor and Date.parse try that format first; use Date.now() or Date.utcNow() for the current time.

new Date(value)

Parameters:

• value
  ticks 数值或受支持的日期文本。

  Numeric ticks or supported date text.

Returns

Date 值。

Date value.

var date = new Date("2026-08-19");
return date.year; // 2026

Date.now()

Parameters:

• 无。

  None.

Returns

当前本地时间的 Date。

Date for current local time.

return Date.now().year;

Date.utcNow()

Parameters:

• 无。

  None.

Returns

当前 UTC 时间的 Date。

Date for current UTC time.

return Date.utcNow().year;

Date.parse(value)

Parameters:

• value
  ticks 或受支持格式的文本。

  Ticks or text in a supported format.

Returns

Date 值。

Date value.

边界行为

不匹配受支持格式的文本不能作为可靠输入。

Text outside supported formats is not reliable input.

return Date.parse("2026-08-19 10:30:00").hour; // 10

var precise = Date.parse("1991-02-01 12:32:55 666");
return precise.millisecond; // 666

日期组成属性

Date component properties

以下属性只读，均从当前 Date 返回数字。

All properties below are read-only and return a number from the current Date.

• date.year
  年。

  Year.
  return Date.now().year;

• date.month
  月（1–12）。

  Month (1–12).
  return Date.now().month;

• date.day
  日。

  Day of month.
  return Date.now().day;

• date.hour
  小时。

  Hour.
  return Date.now().hour;

• date.minute
  分钟。

  Minute.
  return Date.now().minute;

• date.second
  秒。

  Second.
  return Date.now().second;

• date.millisecond
  毫秒。

  Millisecond.
  return Date.now().millisecond;

• date.dayOfWeek
  星期枚举数值。

  Day-of-week enum number.
  return Date.now().dayOfWeek;

• date.dayOfYear
  一年中的第几天。

  Day of year.
  return Date.now().dayOfYear;

• date.ticks
  底层 ticks。

  Underlying ticks.
  return Date.now().ticks;

date.toString([format])

Parameters:

• format
  可选 .NET 日期格式字符串；省略时使用宿主 Runtime.DateTimeFormat。

  Optional .NET date-format string; omitting it uses host Runtime.DateTimeFormat.

Returns

格式化后的日期文本。

Formatted date text.

var date = new Date("2026-08-19");
return date.toString("yyyy/MM/dd"); // 2026/08/19