w2utils.isDateTime

isDateTime(str, [format], [returnDateObj])

文字列が日時であればtrueを返します。 戻り値はboolean、またはDateObjectです。

str: string

チェックする文字列。

format: string

チェックするフォーマット。オプションです。

returnDateObj: boolean

trueを指定した場合、JavaScriptのDateオブジェクトを返します。オプションです。

説明

日付形式を指定することができます。 formatにはmm、dd、yyyy、monを 任意の順序で指定することができます。 例えば、mm.dd.yyyy、dd-mm-yyyy、mon dd, yyyyのように指定することができます。 formatを指定しない場合、.settings.dateFormatと、.settings.timeFormatのフォーマットを使用します。

第3引数のreturnDateObjにtrueを指定した場合、 有効な日付のJavaScriptのDateオブジェクトを返します。

以下のように指定することができます。

var a = w2utils.isDateTime('1/1/2013 1:00pm', 'd/m/yyyy | h:m pm'); // trueまたは、falseを返します。
var a = w2utils.isDateTime('1/1/2013 1:00pm', 'd/m/yyyy | h:m pm', true); // JSのDateオブジェクトを返します。

デモ

日時かどうかをチェックして、結果をconsole.logに出力します。
日本ではyyyy-mm-ddといった形式が一般的なため、 第2引数のformatを渡した方が良いでしょう。

JavaScript

var a = w2utils.isDateTime('1/1/2013 1:00pm', 'd/m/yyyy | h:m pm');
console.log('1/1/2013 1:00pm : ' + a);   // true

a = w2utils.isDateTime('1/1/2013 1:00pm');
console.log('1/1/2013 1:00 pm : ' + a);    // true

a = w2utils.isDateTime('2013/1/1 1:00pm');
console.log('2013/1/1 1:00 pm : ' + a);    // false

a = w2utils.isDateTime('1/1/2013 1:00pm', 'd/m/yyyy | h:m pm', true);
console.log(a);   // Date object