APIリファレンス
GD.time
Unix時刻、ISO 8601、HTTPの日付を変換・計算します。parse_isoはRFC 3339形式を受け取ります。加算や差分が64ビット整数の範囲を超える場合は、最大値または最小値になります。
メソッド
now() -> intto_parts(unix: int) -> Dictionaryfrom_parts(parts: Dictionary) -> intto_iso(unix: int) -> Stringto_http(unix: int) -> Stringparse_iso(text: String) -> int, Erradd(unix: int, amount: int, unit: String = "second") -> intdiff(a: int, b: int, unit: String = "second") -> intstart_of_day(unix: int) -> intweekday(unix: int) -> intis_leap(year: int) -> booldays_in_month(year: int, month: int) -> intago(unix: int, base: int = -1) -> Stringformat(unix: int, pattern: String) -> String
now
now() -> int英語原文Return the current Unix timestamp.
引数
引数はありません。
戻り値
int
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
to_parts
to_parts(unix: int) -> Dictionary英語原文Split a Unix timestamp into date-time components.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
unix | int | 省略不可 | 秒単位のUnix時刻。 |
戻り値
Dictionary
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
from_parts
from_parts(parts: Dictionary) -> int英語原文Convert date-time components into a Unix timestamp.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
parts | Dictionary | 省略不可 | 組み立てる名前やパスなどの各部分。上に示した引数の型に合わせて渡します。 |
戻り値
int
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
to_iso
to_iso(unix: int) -> String英語原文Format a Unix timestamp as ISO 8601 text.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
unix | int | 省略不可 | 秒単位のUnix時刻。 |
戻り値
String
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
to_http
to_http(unix: int) -> String英語原文Format a Unix timestamp as an HTTP date.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
unix | int | 省略不可 | 秒単位のUnix時刻。 |
戻り値
String
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
parse_iso
parse_iso(text: String) -> int, Err英語原文Parse ISO 8601 text into a Unix timestamp.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
text | String | 省略不可 | 調査・デコード・変換する文字列。入力自体は書き換えません。 |
戻り値
int, Err
エラー
処理結果とエラー情報(Err)を返します。Errがnullなら成功です。失敗時にも途中までの結果が残る場合があるため、値を使う前にErrを確認してください。結果とErrを返す関数の中では、?でエラーをそのまま呼び出し元へ返せます。!はエラー時にプログラムを終了します。gd serveでは、そのリクエストの処理だけが終了します。
add
add(unix: int, amount: int, unit: String = "second") -> int英語原文Add an amount in the specified unit to a Unix timestamp.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
unix | int | 省略不可 | 秒単位のUnix時刻。 |
amount | int | 省略不可 | 加算する量。unitで指定する単位で数え、負数なら差し引きます。 |
unit | String | "second" | 時間の加算・比較に使う単位。 |
戻り値
int
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
diff
diff(a: int, b: int, unit: String = "second") -> int英語原文Return the difference between timestamps in the specified unit.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
a | int | 省略不可 | 秒単位の1つ目のUnix時刻。 |
b | int | 省略不可 | 秒単位の2つ目のUnix時刻。 |
unit | String | "second" | 時間の加算・比較に使う単位。 |
戻り値
int
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
start_of_day
start_of_day(unix: int) -> int英語原文Return the start of the same UTC day.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
unix | int | 省略不可 | 秒単位のUnix時刻。 |
戻り値
int
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
weekday
weekday(unix: int) -> int英語原文Return the weekday number for a Unix timestamp.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
unix | int | 省略不可 | 秒単位のUnix時刻。 |
戻り値
int
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
is_leap
is_leap(year: int) -> bool英語原文Check whether a year is a leap year.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
year | int | 省略不可 | 日付計算に使う年。 |
戻り値
bool
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
days_in_month
days_in_month(year: int, month: int) -> int英語原文Return the number of days in a month.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
year | int | 省略不可 | 日付計算に使う年。 |
month | int | 省略不可 | 1から12の月。 |
戻り値
int
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
ago
ago(unix: int, base: int = -1) -> String英語原文Format a timestamp relative to a reference time.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
unix | int | 省略不可 | 秒単位のUnix時刻。 |
base | int | -1 | 基準にする秒単位のUnix時刻。 |
戻り値
String
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
format
format(unix: int, pattern: String) -> String英語原文Format a Unix timestamp with the specified pattern.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
unix | int | 省略不可 | 秒単位のUnix時刻。 |
pattern | String | 省略不可 | 日時の書式パターン。 |
戻り値
String
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。