DateTimeオブジェクト

コンポーネント情報
version	8.0.22
since	8.0.0

コンポーネント概要

タイムゾーンを考慮した日時を扱うためのクラスです。

このクラスで表す年数は 1 ～ 9999 です。

オブジェクトの構造

var dateTime = {
    dayOfMonth : Number, // 日の値
    dayOfWeek : Number, // 曜日の値
    firstDayOfWeek : Number, // 開始曜日の値
    hourOfDay : Number, // 時の値
    lastDayOfMonth : Number, // 月の最終日で、28から31までの数値
    minuteOfHour : Number, // 分の値
    monthOfYear : Number, // 月の値
    secondOfMinute : Number, // 秒の値
    timeZoneId : String, // タイムゾーンID
    year : Number // 年の値
}

var dateTime = {
    dayOfMonth : Number, // 日の値
    dayOfWeek : Number, // 曜日の値
    firstDayOfWeek : Number, // 開始曜日の値
    hourOfDay : Number, // 時の値
    lastDayOfMonth : Number, // 月の最終日で、28から31までの数値
    minuteOfHour : Number, // 分の値
    monthOfYear : Number, // 月の値
    secondOfMinute : Number, // 秒の値
    timeZoneId : String, // タイムゾーンID
    year : Number // 年の値
}

定数

型	定数名	定数値
Numberstatic	APRIL 年の 4 番目の月を示す値です。
Numberstatic	AUGUST 年の 8 番目の月を示す値です。
Numberstatic	DECEMBER 年の 12 番目の月を示す値です。
Numberstatic	FEBRUARY 年の 2 番目の月を示す値です。
Numberstatic	FRIDAY 金曜日を示す値です。
Numberstatic	JANUARY 年の最初の月を示す値です。
Numberstatic	JULY 年の 7 番目の月を示す値です。
Numberstatic	JUNE 年の 6 番目の月を示す値です。
Numberstatic	MARCH 年の 3 番目の月を示す値です。
Numberstatic	MAY 年の 5 番目の月を示す値です。
Numberstatic	MONDAY 月曜日を示す値です。
Numberstatic	NOVEMBER 年の 11 番目の月を示す値です。
Numberstatic	OCTOBER 年の 10 番目の月を示す値です。
Numberstatic	SATURDAY 土曜日を示す値です。
Numberstatic	SEPTEMBER 年の 9 番目の月を示す値です。
Numberstatic	SUNDAY 日曜日を示す値です。
Numberstatic	THURSDAY 木曜日を示す値です。
Numberstatic	TUESDAY 火曜日を示す値です。
Numberstatic	WEDNESDAY 水曜日を示す値です。

コンストラクタの概要

DateTime (Date `date`, TimeZone `[zone]`) コンストラクタ。
DateTime (Number `year`, Number `monthOfYear`, Number `dayOfMonth`, Number `hourOfDay`, Number `minuteOfHour`, Number `secondOfMinute`, Number `firstDayOfWeek`, TimeZone `[zone]`) コンストラクタ。
DateTime (Number `year`, Number `monthOfYear`, Number `dayOfMonth`, Number `hourOfDay`, Number `minuteOfHour`, Number `secondOfMinute`, TimeZone `[zone]`) コンストラクタ。
DateTime (Number `year`, Number `monthOfYear`, Number `dayOfMonth`, Number `hourOfDay`, Number `minuteOfHour`, TimeZone `[zone]`) コンストラクタ。
DateTime (Number `year`, Number `monthOfYear`, Number `dayOfMonth`, Number `hourOfDay`, TimeZone `[zone]`) コンストラクタ。
DateTime (Number `year`, Number `monthOfYear`, Number `dayOfMonth`, TimeZone `[zone]`) コンストラクタ。
DateTime (TimeZone `[zone]`) コンストラクタ。

プロパティの概要

型	プロパティ名	アクセス権
Number	dayOfMonth 日の値	読み取り専用
Number	dayOfWeek 曜日の値	読み取り専用
Number	firstDayOfWeek 開始曜日の値	読み取り専用
Number	hourOfDay 時の値	読み取り専用
Number	lastDayOfMonth 月の最終日で、28から31までの数値	読み取り専用
Number	minuteOfHour 分の値	読み取り専用
Number	monthOfYear 月の値	読み取り専用
Number	secondOfMinute 秒の値	読み取り専用
String	timeZoneId タイムゾーンID	読み取り専用
Number	year 年の値	読み取り専用

メソッドの概要

返却値の型	メソッド名
ResultObject	clone () この DateTime のコピーを作成して、返します。
ResultObject	getDate () この DateTime のエポックミリ秒を持つ Date を返します。
ResultObject	getTimeZoneOffset () この DateTime が持つタイムゾーン・オフセット値をミリ秒単位で取得します。
ResultObject	getTimeZone () この DateTime が持つタイムゾーンを取得します。
ResultObject	getTime () この DateTime をエポックミリ秒に変換した値を取得します。
ResultObject	minusDays (Number `days`) 指定された日数を減算した DateTime のコピーを返します。
ResultObject	minusHours (Number `hours`) 指定された時間数を減算した DateTime のコピーを返します。
ResultObject	minusMinutes (Number `minutes`) 指定された分数を減算した DateTime のコピーを返します。
ResultObject	minusMonths (Number `months`) 指定された月数を減算した DateTime のコピーを返します。
ResultObject	minusSeconds (Number `seconds`) 指定された秒数を減算した DateTime のコピーを返します。
ResultObject	minusYears (Number `years`) 指定された年数を減算した DateTime のコピーを返します。
ResultObject	plusDays (Number `days`) 指定された日数を加算した DateTime のコピーを返します。
ResultObject	plusHours (Number `hours`) 指定された時間数を加算した DateTime のコピーを返します。
ResultObject	plusMinutes (Number `minutes`) 指定された分数を加算した DateTime のコピーを返します。
ResultObject	plusMonths (Number `months`) 指定された月数を加算した DateTime のコピーを返します。
ResultObject	plusSeconds (Number `seconds`) 指定された秒数を加算した DateTime のコピーを返します。
ResultObject	plusYears (Number `years`) 指定された年数を加算した DateTime のコピーを返します。
String	toString () DateTime を次の形式の String に変換します。
ResultObject	withDayOfMonth (Number `dayOfMonth`) 日付の日のみを変更した DateTime のコピーを返します。
ResultObject	withHourOfDay (Number `hourOfDay`) 時刻の時間のみを変更した DateTime のコピーを返します。
ResultObject	withMilliOfSecond (Number `milliOfSecond`) ミリ秒のみを変更した DateTime のコピーを返します。
ResultObject	withMinuteOfHour (Number `minuteOfHour`) 時刻の分のみを変更した DateTime のコピーを返します。
ResultObject	withMonthOfYear (Number `monthOfYear`) 日付の月のみを変更した DateTime のコピーを返します。
ResultObject	withSecondOfMinute (Number `secondOfMinute`) 時刻の秒のみを変更した DateTime のコピーを返します。
ResultObject	withTimeZone (TimeZone `zone`) 指定のタイムゾーンに変換された DateTime のコピーを返します。
ResultObject	withYear (Number `year`) 日付の年のみを変更した DateTime のコピーを返します。

コンストラクタの詳細

DateTime (Date date, TimeZone [zone])

コンストラクタ。

タイムゾーンを指定して、システムの現在日時を持つ DateTime を生成します。
タイムゾーンが指定されていない場合、アカウントコンテキストから解決されます。

パラメータ

date : Date: 指定する Date、null ではない

[zone] : TimeZone: 指定するタイムゾーン、null ではない

DateTime (Number year, Number monthOfYear, Number dayOfMonth, Number hourOfDay, Number minuteOfHour, Number secondOfMinute, Number firstDayOfWeek, TimeZone [zone])

コンストラクタ。

タイムゾーンと年月日時分秒、週の開始曜日を指定して、DateTime を生成します。
タイムゾーンが指定されていない場合、アカウントコンテキストから解決されます。

パラメータ

year : Number: 指定する年（1～9999）

monthOfYear : Number: 指定する月（January で 0 、最後は 1 年の月の数による）

dayOfMonth : Number: 指定する日（初めは 1 で、最後は月による）

hourOfDay : Number: 指定する 24 時間制の時刻（0～23）

minuteOfHour : Number: 指定する分（0～59）

secondOfMinute : Number: 指定する秒（0～59）

firstDayOfWeek : Number: 指定する週の開始曜日

[zone] : TimeZone: 指定するタイムゾーン、null ではない

DateTime (Number year, Number monthOfYear, Number dayOfMonth, Number hourOfDay, Number minuteOfHour, Number secondOfMinute, TimeZone [zone])

コンストラクタ。

タイムゾーンと年月日時分秒を指定して、DateTime を生成します。
タイムゾーンが指定されていない場合、アカウントコンテキストから解決されます。

パラメータ

year : Number: 指定する年（1～9999）

monthOfYear : Number: 指定する月（January で 0 、最後は 1 年の月の数による）

dayOfMonth : Number: 指定する日（初めは 1 で、最後は月による）

hourOfDay : Number: 指定する 24 時間制の時刻（0～23）

minuteOfHour : Number: 指定する分（0～59）

secondOfMinute : Number: 指定する秒（0～59）

[zone] : TimeZone: 指定するタイムゾーン、null ではない

DateTime (Number year, Number monthOfYear, Number dayOfMonth, Number hourOfDay, Number minuteOfHour, TimeZone [zone])

コンストラクタ。

タイムゾーンと年月日時分を指定して、DateTime を生成します。
秒には 0 がセットされます。
タイムゾーンが指定されていない場合、アカウントコンテキストから解決されます。

パラメータ

year : Number: 指定する年（1～9999）

monthOfYear : Number: 指定する月（January で 0 、最後は 1 年の月の数による）

dayOfMonth : Number: 指定する日（初めは 1 で、最後は月による）

hourOfDay : Number: 指定する 24 時間制の時刻（0～23）

minuteOfHour : Number: 指定する分（0～59）

[zone] : TimeZone: 指定するタイムゾーン、null ではない

DateTime (Number year, Number monthOfYear, Number dayOfMonth, Number hourOfDay, TimeZone [zone])

コンストラクタ。

タイムゾーンと年月日時を指定して、DateTime を生成します。
分秒には 0 がセットされます。
タイムゾーンが指定されていない場合、アカウントコンテキストから解決されます。

パラメータ

year : Number: 指定する年（1～9999）

monthOfYear : Number: 指定する月（January で 0 、最後は 1 年の月の数による）

dayOfMonth : Number: 指定する日（初めは 1 で、最後は月による）

hourOfDay : Number: 指定する 24 時間制の時刻（0～23）

[zone] : TimeZone: 指定するタイムゾーン、null ではない

DateTime (Number year, Number monthOfYear, Number dayOfMonth, TimeZone [zone])

コンストラクタ。

タイムゾーンと年月日を指定して、DateTime を生成します。
時分秒には 0 がセットされます。
タイムゾーンが指定されていない場合、アカウントコンテキストから解決されます。

パラメータ

year : Number: 指定する年（1～9999）

monthOfYear : Number: 指定する月（January で 0 、最後は 1 年の月の数による）

dayOfMonth : Number: 指定する日（初めは 1 で、最後は月による）

[zone] : TimeZone: 指定するタイムゾーン、null ではない

DateTime (TimeZone [zone])

パラメータ

[zone] : TimeZone: 指定するタイムゾーン、null ではない

プロパティの詳細

Number dayOfMonth 読み取り専用

日の値

Number dayOfWeek 読み取り専用

曜日の値

Number firstDayOfWeek 読み取り専用

開始曜日の値

Number hourOfDay 読み取り専用

時の値

Number lastDayOfMonth 読み取り専用

月の最終日で、28から31までの数値

Number minuteOfHour 読み取り専用

分の値

Number monthOfYear 読み取り専用

月の値

Number secondOfMinute 読み取り専用

秒の値

String timeZoneId 読み取り専用

タイムゾーンID

Number year 読み取り専用

年の値

メソッドの詳細

ResultObject clone ()

この DateTime のコピーを作成して、返します。

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティにはこの DateTime のコピーが設定されます。

ResultObject getDate ()

この DateTime のエポックミリ秒を持つ Date を返します。

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには Date が設定されます。

ResultObject getTimeZoneOffset ()

この DateTime が持つタイムゾーン・オフセット値をミリ秒単位で取得します。

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティにはミリ秒単位のタイムゾーン・オフセット(Number)が設定されます。

ResultObject getTimeZone ()

この DateTime が持つタイムゾーンを取得します。

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには TimeZone が設定されます。

ResultObject getTime ()

この DateTime をエポックミリ秒に変換した値を取得します。

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティにはエポックミリ秒(Number)が設定されます。

ResultObject minusDays (Number days)

指定された日数を減算した DateTime のコピーを返します。

このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

days : Number: 減算する日数、正または 0 または負

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定された日数を減算した DateTime が設定されます。

ResultObject minusHours (Number hours)

指定された時間数を減算した DateTime のコピーを返します。

このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

hours : Number: 減算する時間数、正または 0 または負

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定された時間数を減算した DateTime が設定されます。

ResultObject minusMinutes (Number minutes)

指定された分数を減算した DateTime のコピーを返します。

このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

minutes : Number: 減算する分数、正または 0 または負

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定された分数を減算した DateTime が設定されます。

ResultObject minusMonths (Number months)

指定された月数を減算した DateTime のコピーを返します。

このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

months : Number: 減算する月数、正または 0 または負

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定された月数を減算した DateTime が設定されます。

ResultObject minusSeconds (Number seconds)

指定された秒数を減算した DateTime のコピーを返します。

このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

seconds : Number: 減算する秒数、正または 0 または負

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定された秒数を減算した DateTime が設定されます。

ResultObject minusYears (Number years)

指定された年数を減算した DateTime のコピーを返します。

このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

years : Number: 減算する年数、正または 0 または負

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定された年数を減算した DateTime が設定されます。

ResultObject plusDays (Number days)

指定された日数を加算した DateTime のコピーを返します。

このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

days : Number: 加算する日数、正または 0 または負

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定された日数を加算した DateTime が設定されます。

ResultObject plusHours (Number hours)

指定された時間数を加算した DateTime のコピーを返します。

このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

hours : Number: 加算する時間数、正または 0 または負

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定された時間数を加算した DateTime が設定されます。

ResultObject plusMinutes (Number minutes)

指定された分数を加算した DateTime のコピーを返します。

このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

minutes : Number: 加算する分数、正または 0 または負

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定された分数を加算した DateTime が設定されます。

ResultObject plusMonths (Number months)

指定された月数を加算した DateTime のコピーを返します。

このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

months : Number: 加算する月数、正または 0 または負

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定された月数を加算した DateTime が設定されます。

ResultObject plusSeconds (Number seconds)

指定された秒数を加算した DateTime のコピーを返します。

このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

seconds : Number: 加算する秒数、正または 0 または負

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定された秒数を加算した DateTime が設定されます。

ResultObject plusYears (Number years)

指定された年数を加算した DateTime のコピーを返します。

このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

years : Number: 加算する年数、正または 0 または負

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定された年数を加算した DateTime が設定されます。

String toString ()

DateTime を次の形式の String に変換します。

 E MMM dd yyyy HH:mm:ss GMT##### (z)

説明

Eは曜日 (Sun, Mon, Tue, Wed, Thu, Fri, Sat)
MMMは月 (Jan,Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec)
ddは 2 桁の 10 進数である月の日 (01 ～ 31)
yyyyは 4 桁の 10 進数である年
HHは 2 桁の 10 進数である日の時 (00 ～ 23)
mmは 2 桁の 10 進数である時の分 (00 ～ 59)
ssは 2 桁の 10 進数である分の秒 (00 ～ 61)
GMT#####GMT との時差。##### は RFC 822 の 4 桁タイムゾーン形式。
(z)はタイムゾーン (夏時間を反映する場合がある)。

返却値

String: String DateTimeの文字列表現

ResultObject withDayOfMonth (Number dayOfMonth)

日付の日のみを変更した DateTime のコピーを返します。
このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

dayOfMonth : Number: 指定する日（初めは 1 で、最後は月による）

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには日のみを変更した DateTime が設定されます。

ResultObject withHourOfDay (Number hourOfDay)

時刻の時間のみを変更した DateTime のコピーを返します。
このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

hourOfDay : Number: 指定する時間（0～23）

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには時間が変更された DateTime が設定されます。

ResultObject withMilliOfSecond (Number milliOfSecond)

ミリ秒のみを変更した DateTime のコピーを返します。
このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

milliOfSecond : Number: 指定するミリ秒（0～999）

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティにはミリ秒が変更された DateTime が設定されます。

ResultObject withMinuteOfHour (Number minuteOfHour)

時刻の分のみを変更した DateTime のコピーを返します。
このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

minuteOfHour : Number: 指定する分（0～59）

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには分が変更された DateTime が設定されます。

ResultObject withMonthOfYear (Number monthOfYear)

日付の月のみを変更した DateTime のコピーを返します。
このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

monthOfYear : Number: 指定する月（January で 0、最後は 1 年の月の数による）

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには月のみを変更した DateTime が設定されます。

ResultObject withSecondOfMinute (Number secondOfMinute)

時刻の秒のみを変更した DateTime のコピーを返します。
このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

secondOfMinute : Number: 指定する秒（0～59）

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには秒が変更された DateTime が設定されます。

ResultObject withTimeZone (TimeZone zone)

指定のタイムゾーンに変換された DateTime のコピーを返します。
エポックミリ秒を変更しませんが、タイムゾーンを変換するので、日時は変化します。
このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

zone : TimeZone: 指定するタイムゾーン、null ではない

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには指定のタイムゾーンに変換された DateTime が設定されます。

ResultObject withYear (Number year)

日付の年のみを変更した DateTime のコピーを返します。
このメソッドの呼び出しによって、コピー元のインスタンスは影響を受けません。

パラメータ

year : Number: 指定する年（1～9999）

返却値

ResultObject: ResultObject 処理結果オブジェクト
dataプロパティには年のみを変更した DateTime が設定されます。