Date

Dateは、オンライン・レポートにデータが挿入された日付と時刻、またはスナップショット・レポートが保存された日付と時刻を戻すテキスト関数です。これらの日付と時刻は、レポート・サーバーから取得され、レポート・サーバーがある国の日付と時刻に対応します。Dateは、テキスト・ボックス、テキスト・セル、行見出し、列見出しで使用できます。

構文:

<<Date("format”,”TimeZoneId”)>>

引数	説明
format	デフォルトで日付/時刻のユーザー・プリファレンスに設定されます。有効な値は、Java SimpleDateFormat、userまたはempty ("user")で使用される値です。 日付と時刻のformat文字では、大文字と小文字が区別されます。
TimeZoneId	デフォルトでタイムゾーンのユーザー・プリファレンスに設定されます。有効な値は、Java TimeZone.getTimeZone()、またはサーバーのタイムゾーンで使用される値です。たとえば、TimeZone.getTimeZone()の場合、東海岸を指定するには次のように入力します: "America/New_York"。 TimeZoneIDを使用している場合は、formatパラメータを引用符で囲む必要があります。これは、TimeZoneIdが示されている場合にのみ適用します。TimeZoneIdを増加させる前のレポートを更新する必要はありません。

表27. 日付と時刻のフォーマット用の文字

フォーマット用の文字	意味	データ型	例
G	紀元	テキスト	AD
M	月	テキストまたは数値	7月の場合、Mでは7、MMでは07、MMMではJul、MMMMではJulyと表示されます。
d	日	数値	10
h	時(午前/午後1-12時)	数値	11
H	時(0-23時)	数値	22
m	分	数値	30
s	秒	数値	25
S	ミリ秒	数値	978
E	曜日	テキスト	E: Tue EE: Tuesday
D	元旦から数えた日数	数値	189
F	月の初めから数えた曜日	数値	<<Date(“dd-MMM-yy ‘is the’ F 'th ' E 'of' ‘MMM”)>>は、次のような値を戻します。 24-Dec-02はDecの第4 Tue
w	元旦から数えた週の数	数値	27
W	月の初めから数えた週	数値	2
a	午前/午後のマーカー	テキスト	PM
k	時(1-24時)	数値	23
K	時(午前/午後0-11時)	数値	午後3時37分の場合は、3を戻します。
z	タイム・ゾーン	テキスト	太平洋標準時
y	年	数値	2002,02
'	リテラル・テキスト	テキスト	<<Date(“ D’the day of ’yyyy”)>>は、「2002年の105日目」となります。
' '	2つ続けた一重引用符で、1つの一重引用符を示す	テキスト	<<Date(“k:mm ‘O’’Clock’ a”)>>は、「6:15 O'Clock PM」となります。 注: O'Clockのように、一重引用符やアポストロフィを表示するには、一重引用符を 2つ続けて使用します(O''Clock)。

format文字を使用する際の考慮事項:

• format文字の個数によって、フォーマットが決まります。

  • テキストでは、パターンを示す文字が4文字未満の場合は、短縮形または略号を使用することを意味します。

  • 4文字以上は、完全な形式を使用することを意味します。

  • MとMMは、月の数字を使用することを意味します。

  • MMMは、月の3文字の短縮形(英語)を使用することを意味します。

  • MMMMは、月の完全な名前(英語)を使用することを意味します。

  たとえば、4月24日の場合は、次のようになります。

  <<Date("dd-M-yy")>>は、24-4-02となります。

  <<Date("dd-MM-yy")>>は、24-04-02となります。

  <<Date("dd-MMM-yy")>>は、24-Apr-02となります。

  <<Date("dd-MMMM-yy")>>は、24-April-02となります。

• 数字の場合は、数字のパターンを示す文字の個数は最小の桁数を示します。それより桁数の短い数字には足りない桁にゼロが挿入されます。年は特別な例です。"yy"では年数の最後の2桁が表示され、"yyyy"では4桁で年が表示されます。

  たとえば、2月の場合は、次のように表示されます。

  <<Date("MM-yyyy")>>は、02-2002となります。

• すべて大文字で示されたアルファベット、またはすべて小文字で示されたアルファベットは、特別なformat文字であるかどうかにかかわらず、パターンとしてみなされます。

• リテラル・テキストは一重引用符で囲みます。一重引用符(アポストロフィ)をリテラル・テキストで使用する場合は、テキスト全体を一重引用符で囲んだ上で、アポストロフィのかわりに一重引用符を2つ続けて使用します。

  たとえば、4 o'clockと出力するためのフォーマットは、次のとおりです。

   <<Date("hh 'o''clock' ")>>

例:

日付フォーマット	結果
<<Date("d/M/yy")>>	23/3/02
<<Date("d-MMM-yy")>>	23-Mar-02
<<Date("EEEE, MMMM dd, yyyy")>>	Tuesday, March 23, 2002
<<Date("h:mm:ss a")>>	12:52:05 PM
<<Date("h:mm:ss a zzzz")>>	12:52:05 PM東部標準時
<<Date("EEEE, MMMM dd, yyyy G 'time:' h:mm:ss a zzzz")>>	Tuesday, March 23, 2002 AD 時刻: 12:52:05 PM 東部標準時
<<Date("hh 'o’’clock' a, zzzz")>>	12:00 PM東部標準時 注: テキスト内に1つの一重引用符が表示されるようにするには、一重引用符を2つ続けて入力する必要があります。