日付データの日情報に対して指定増分を加算するオブジェクト。
メソッドの概要 | |
static
| addDay(Date date ,Number plus) |
static
| addHour(Date date ,Number plus) |
static
| addMinute(Date date ,Number plus) |
static
| addMonth(Date date ,Number plus) |
static
| addSecond(Date date ,Number plus) |
static
| addYear(Date date ,Number plus) |
static
| dayName(Date date) |
static
| get(number year ,number month ,number day ,number hour ,number minute ,numbe second) |
static
| getFuture(Date target_a ,Date target_b) |
static
| getFuture(Date target_a) |
static
| getPast(Date target_a ,Date target_b) |
static
| getPast(Date target_a) |
static
| getYear(Date date) |
static
| interval(Date target_a ,Date target_b) |
static
| intervalDay(Date target_a ,Date target_b) |
static
| intervalHour(Date target_a ,Date target_b) |
static
| intervalMinute(Date target_a ,Date target_b) |
static
| intervalMonth(Date target_a ,Date target_b) |
static
| intervalSecond(Date target_a ,Date target_b) |
static
| intervalYear(Date target_a ,Date target_b) |
static
| isBetween(Date left ,String l_op ,Date target ,String r_op ,Date right) |
static
| isBetween(Date left ,String l_op ,Date target) |
static
| isFuture(Date target) |
static
| isLeapYear(Date target) |
static
| isPast(Date target) |
static
| isValid(Number year ,Number month ,Number day) |
static
| monthName(Date target) |
static
| today() |
メソッドの詳細 |
static |
| addDay(Date date ,Number plus) |
日付データの日情報に対して指定増分を加算します。
指定日付データの日情報に対して、 指定増分値を加算した結果の日付データを返却します。
パラメータ
date Date 対象データ plus Number 増加分
返却値
Date 指定増分を加算した結果の日付データ
static |
| addHour(Date date ,Number plus) |
日付データの時間情報に対して指定増分を加算します。
指定日付データの時間情報に対して、 指定増分値を加算した結果の日付データを返却します。
パラメータ
date Date 対象データ plus Number 増加分
返却値
Date 指定増分を加算した結果の日付データ
static |
| addMinute(Date date ,Number plus) |
日付データの分情報に対して指定増分を加算します。
指定日付データの分情報に対して、 指定増分値を加算した結果の日付データを返却します。
パラメータ
date Date 対象データ plus Number 増加分
返却値
Date 指定増分を加算した結果の日付データ
static |
| addMonth(Date date ,Number plus) |
日付データの月情報に対して指定増分を加算します。
指定日付データの月情報に対して、 指定増分値を加算した結果の日付データを返却します。
パラメータ
date Date 対象データ plus Number 増加分
返却値
Date 指定増分を加算した結果の日付データ
static |
| addSecond(Date date ,Number plus) |
日付データの秒情報に対して指定増分を加算します。
指定日付データの秒情報に対して、 指定増分値を加算した結果の日付データを返却します。
パラメータ
date Date 対象データ plus Number 増加分
返却値
Date 指定増分を加算した結果の日付データ
static |
| addYear(Date date ,Number plus) |
日付データの年情報に対して指定増分を加算します。
指定日付データの年情報に対して、 指定増分値を加算した結果の日付データを返却します。
パラメータ
date Date 対象データ plus Number 増加分
返却値
Date 指定増分を加算した結果の日付データ
static |
| dayName(Date date) |
曜日を表す文字列を取得します。
以下の曜日を表すキーワード文字列を返却します。 Sunday : 日曜日 Monday : 月曜日 Tuesday : 火曜日 Wednesday: 水曜日 Thursday : 木曜日 Friday : 金曜日 Saturday : 土曜日
パラメータ
date Date 対象データ
返却値
String 指定の日付データが表す曜日を示すキーワード文字列
static |
| get(number year ,number month ,number day ,number hour ,number minute ,numbe second) |
変数データの型をチェックします。
指定された日付情報を表す日付型オブジェクトを生成して返却します。 引数 hour, minute, second を省略した場合、0 が適応されます。
パラメータ
year number 年(数字) month number 月(数字) day number 日(数字) hour number 時(数字) minute number 分(数字) second numbe 秒(数字)
返却値
Date 指定日付を表す日付型オブジェクト
static |
| getFuture(Date target_a ,Date target_b) |
未来を表す日付データを取得します。
引数に与えられた2つの日付データのうち、より未来を示す日付データを 返却します。 このメソッドは、元のデータに影響を与えません。
パラメータ
target_a Date チェック対象データa target_b Date チェック対象データb
返却値
Date 2つの日付データのうち未来を示す方の日付データ
static |
| getFuture(Date target_a) |
未来を表す日付データを取得します。
このメソッドの実行時の“現在”を 表す日付データと引数 target_a との比較が行われ、 より未来を示す日付データを返却します。 このメソッドは、元のデータに影響を与えません。
パラメータ
target_a Date チェック対象データa
返却値
Date メソッド実行時の“現在”を表す日付データと引数 target_aのうち未来を示す方の日付データ
static |
| getPast(Date target_a ,Date target_b) |
過去を表す日付データを取得します。
引数に与えられた2つの日付データのうち、より過去を示す日付データを 返却します。 このメソッドは、元のデータに影響を与えません。
パラメータ
target_a Date チェック対象データa target_b Date チェック対象データb
返却値
Date 2つの日付データのうち過去を示す方の日付データ
static |
| getPast(Date target_a) |
過去を表す日付データを取得します。
このメソッドの実行時の“現在”を 表す日付データと引数 target_a との比較が行われ、 より過去を示す日付データを返却します。 このメソッドは、元のデータに影響を与えません。
パラメータ
target_a Date チェック対象データa
返却値
Date メソッド実行時の“現在”を表す日付データと引数 target_aのうち過去を示す方の日付データ
static |
| getYear(Date date) |
西暦年を取得します。
指定の日付データの表す年情報を4桁で返却します。 このメソッドでは西暦 0 〜 1000 年の間のデータを扱う事はできません。
パラメータ
date Date 対象データ
返却値
Number 指定日付データの表す西暦年
static |
| interval(Date target_a ,Date target_b) |
2つの日付データの時間間隔を取得します。
指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“年”です。 返却データは、浮動小数点形式で表され、小数点以下は12進法で 表されます。 例)23ヶ月→1.11年
パラメータ
target_a Date チェック対象データ a target_b Date チェック対象データ b
返却値
Number 2つの日付データの時間的差分
static |
| intervalDay(Date target_a ,Date target_b) |
2つの日付データの時間間隔を取得します。
指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“日”です。
パラメータ
target_a Date チェック対象データa target_b Date チェック対象データb
返却値
Number 2つの日付データの時間的差分
static |
| intervalHour(Date target_a ,Date target_b) |
2つの日付データの時間間隔を取得します。
指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“時間”です。
パラメータ
target_a Date チェック対象データa target_b Date チェック対象データb
返却値
Number 2つの日付データの時間的差分
static |
| intervalMinute(Date target_a ,Date target_b) |
2つの日付データの時間間隔を取得します。
指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“分”です。
パラメータ
target_a Date チェック対象データa target_b Date チェック対象データb
返却値
Number 2つの日付データの時間的差分
static |
| intervalMonth(Date target_a ,Date target_b) |
2つの日付データの時間間隔を取得します。
指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“月”です。
パラメータ
target_a Date チェック対象データa target_b Date チェック対象データb
返却値
Number 2つの日付データの時間的差分
static |
| intervalSecond(Date target_a ,Date target_b) |
2つの日付データの時間間隔を取得します。
指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“秒”です。
パラメータ
target_a Date チェック対象データa target_b Date チェック対象データb
返却値
Number 2つの日付データの時間的差分
static |
| intervalYear(Date target_a ,Date target_b) |
2つの日付データの時間間隔を取得します。
指定の2つの日付データの時間間隔を計算して返却します。 返却するデータの単位は“年”です。
パラメータ
target_a Date チェック対象データa target_b Date チェック対象データb
返却値
Number 2つの日付データの時間的差分
static |
| isBetween(Date left ,String l_op ,Date target ,String r_op ,Date right) |
日付情報の範囲をチェックします。
チェック対象日付データを左辺および右辺の両境界における範囲チェック を指定のオペレーションでおこないます。
チェックオペレータは、以下のキーワードにより指定します。 "<" or ">" :大小比較1(同値は含まない) "<=" or ">=":大小比較2(同値も真とする) "= =" :同値比較(同値の場合を真とする) "<>" or "!=":異値比較(値が異なる場合を真とする)
例)var datA = Module.date.get(2000, 1, 1); var datB = Module.date.get(2001, 1, 1); var datNow = Module.date.getToday();
Module.date.isBetween(datA, "<=", datNow, "<", datB); この返却値で、“今日”が2000年であるかを判定できる。 注意)このメソッドのチェックは、ミリ秒単位にて判定します。 Module.date.isBetween(new Date() , "= =", new Date()); これは、偽値(false)になる可能性があります。
パラメータ
left Date 左辺境界を表す日付データ l_op String 左辺チェックオペレータ target Date チェック対象日付データ r_op String 右辺チェックオペレータ right Date 右辺境界を表す日付データ
返却値
Boolean
真値:対象日付データは指定の範囲に合致 偽値:対象日付データは指定の範囲外を表します。
static |
| isBetween(Date left ,String l_op ,Date target) |
日付情報の範囲をチェックします。
チェック対象日付データを左辺および右辺の両境界における範囲チェック を指定のオペレーションでおこないます。
チェックオペレータは、以下のキーワードにより指定します。 "<" or ">" :大小比較1(同値は含まない) "<=" or ">=":大小比較2(同値も真とする) "= =" :同値比較(同値の場合を真とする) "<>" or "!=":異値比較(値が異なる場合を真とする)
例)var datA = Module.date.get(2000, 1, 1); var datB = Module.date.get(2001, 1, 1); var datNow = Module.date.getToday();
Module.date.isBetween(datA, "<=", datNow, "<", datB); この返却値で、“今日”が2000年であるかを判定できる。 注意)このメソッドのチェックは、ミリ秒単位にて判定します。 Module.date.isBetween(new Date() , "= =", new Date()); これは、偽値(false)になる可能性があります。
パラメータ
left Date 左辺境界を表す日付データ l_op String 左辺チェックオペレータ target Date チェック対象日付データ
返却値
Boolean
真値:対象日付データは指定の範囲に合致 偽値:対象日付データは指定の範囲外を表します。
static |
| isFuture(Date target) |
日付データが未来を示すかどうかをチェックします。
指定の日付データが、このメソッド実行時における“現在”時間よりも 未来である場合 true を返却し、過去である場合 false を返却します。 指定の日付データが、このメソッド実行時における“現在”時間と 等しい場合には、false が返却されます。
パラメータ
target Date チェック対象データ
返却値
Boolean
真値:指定の日付データは、現在よりも未来 偽値:指定日付データは、現在よりも過去
static |
| isLeapYear(Date target) |
閏年チェックをします。
指定日付の年が閏年に該当しているかをチェックしています。 太陽暦(グレゴリオ歴)を基本として計算されています。
パラメータ
target Date チェック対象データ
返却値
Boolean
真値:指定年は閏年 偽値:指定年は閏年ではない
static |
| isPast(Date target) |
日付データが過去を示すかどうかをチェックします。
指定の日付データが、このメソッド実行時における“現在”時間よりも 過去である場合 true を返却し、未来である場合 false を返却します。 指定の日付データが、このメソッド実行時における“現在”時間と 等しい場合には、false が返却されます。
パラメータ
target Date チェック対象データ
返却値
Boolean
真値:指定の日付データは、現在よりも過去 偽値:指定日付データは、現在よりも未来
static |
| isValid(Number year ,Number month ,Number day) |
日付データとしての正当性をチェックします 。
指定年月日情報が日付データとして正しい値である事をチェックします。
パラメータ
year Number チェック対象年 month Number チェック対象月 day Number チェック対象日
返却値
Boolean
真値:指定データは日付として正しい値を示している 偽値:指定データは日付データとして正しくない
static |
| monthName(Date target) |
月を表す文字列を取得します。
以下の月を表すキーワード文字列を返却します。
January : 1月 February : 2月 March : 3月 April : 4月 May : 5月 June : 6月 July : 7月 August : 8月 September : 9月 October : 10月 November : 11月 December : 12月
パラメータ
target Date チェック対象データ
返却値
String 指定日付データの表す月を示すキーワード文字列
static |
| today() |
“今日”という日付を表す日付オブジェクトを取得します。
実行時の日にちを表す日付型データを生成して返却します。
生成された日付型データの表す年月日情報は、メソッド実行時の日付を 表し、時間は 00:00:00:000 を表します。
返却値
Date “今日”を表す日付オブジェクト