日付と時間の構造

エポック

日付と時間には、時間の始点を示すエポックが関連付けられています。このエポックよりも前の日付の値や時間の値はすべて無効です。

すべての日付関数の値は、エポックからの日数で表されます。すべての時間関数の値は、エポックからのミリ秒数で表されます。

Designer では、すべての日付関数のエポックとして第 1 日目を 1900 年 1 月 1 日、すべての時間関数のエポックとして第 1 ミリ秒目をグリニッジ標準時(GMT)の 00:00:00 と定義しています。この定義では、GMT より東の時間帯にいるユーザーに負の時間値が返されることがあります。

日付形式

日付形式は日付の略記方法で、日付が使用する形式を表す各種の句読点や記号で構成されています。次に示す表は日付形式の例です。

日付形式

MM/DD/YY

11/11/78

DD/MM/YY

25/07/85

MMMM DD, YYYY

March 10, 1964

日付形式は ISO 標準で管理されています。各国または地域によって独自の形式が指定されます。一般的に、日付形式には、ショート形式、標準形式、ロング形式、フル形式の 4 種類があります。次の表に、4 つのカテゴリ別に異なるロケールの異なる時間形式の例を示します。

ロケール識別子と説明

日付形式(カテゴリ)

en_GB

英語(英国)

DD/MM/YY(ショート形式)

08/12/92

08/04/05

fr_CA

フランス語(カナダ)

YY-MM-DD(標準形式)

92-08-18

de_DE

ドイツ語(ドイツ)

D. MMMM YYYY(ロング形式)

17. Juni 1989

fr_FR

フランス語(フランス)

EEEE, ' le ' D MMMM YYYY(フル形式)

Lundi 29 Octobre 1990

時間形式

時間形式は、時間の形式を簡単に指定したもので、句読点、リテラル、パターン記号によって構成されています。次に示す表は時間形式の例です。

時間形式

h:MM A

7:15 PM

HH:MM:SS

21:35:26

HH:MM:SS 'o''clock' A Z

14:20:10 o’clock PM EDT

時間形式は ISO 標準で管理されています。時間形式についても、デフォルト形式、ショート形式、標準形式、ロング形式、フル形式を各国が指定しています。ロケールは、その国の標準に合った時間形式を識別する役割を担っています。

次の表に、4 つのカテゴリ別に異なるロケールの異なる時間形式の例を示します。

ロケール識別子と説明

時間形式(カテゴリ)

en_GB

英語(英国)

HH:MM(ショート形式)

14:13

fr_CA

フランス語(カナダ)

HH:MM:SS(標準形式)

12:15:50

de_DE

ドイツ語(ドイツ)

HH:MM:SS z(ロング形式)

14:13:13 -0400

fr_FR

フランス語(フランス)

HH ' h ' MM Z(フル形式)

14 h 13 GMT-04:00

日付と時間のパターン形式

日付 / 時間フィールドに日時パターンを作成するには、次の記号を使用する必要があります。一部の日付記号は、中国語、日本語および韓国語ロケールでのみ使用します。それらの記号についても下で説明します。

注意: コンマ(,)、ダッシュ(-)、コロン(:)、スラッシュ(/)、ピリオド(.)およびスペース( )はリテラル値として扱われ、パターンのどこでも使用できます。パターンにテキスト文字列を含めるには、文字列を一重引用符(')で囲みます。例えば、表示パターンとして 'お客様の支払期限:' MM-DD-YY を指定できます。

日付記号

説明

ロケールが英語(米国)に形式設定された値の、ロケール依存の入力値が 1/1/08(2008 年 1 月 1 日)の場合

D

月の日付を、1 桁または 2 桁の数値(1 ~ 31)で表します。

1

DD

月の日付を 2 桁の数値(01 ~ 31)で表します。

01

J

1 年の何日目かを、1 桁、2 桁または 3 桁の数値(1 ~ 366)で表します。

1

JJJ

1 年の何日目かを 3 桁の数値(001 ~ 366)で表します。

001

M

月を 1 桁または 2 桁の数値(1 ~ 12)で表します。

1

MM

月を 2 桁(01 ~ 12)の数値で表します。

01

MMM

月名を略称で表示します。

Jan

MMMM

月名を略さずに表示します。

January

E

曜日を 1 桁の数字(1 ~ 7)の数値で表します。ここで 1 は日曜日です。

3(2008 年 1 月 1 日は火曜日のため)

EEE

曜日を略称で表示します。

Tue(2008 年 1 月 1 日は火曜日のため)

EEEE

曜日を略さずに表示します。

Tuesday(2008 年 1 月 1 日は火曜日のため)

YY

年(西暦)を 2 桁で表します。30 未満の数値は 2000 年より後、30 を超える数値は 2000 年より前を表します。例えば、00=2000、29=2029、30=1930、99=1999 となります。

08

YYYY

年(西暦)を 4 桁で表します。

2008

G

紀元名(BC または AD)を表示します。

AD

w

月の第何週かを 1 桁の数値(0 ~ 5)で表します。その月で最も早く、土曜日で終わる連続した 4 日間が第 1 週になります。

1

WW

年の第何週かを表す 2 桁の数値(01 ~ 53)で、ISO-8601 に規定されています。1 月 4 日を含む週が第 1 週になります。

01

中国語、日本語および韓国語ロケールの日付パターン指定用に、追加の日付パターンがいくつかあります。

日本語の元号は数種類の記号で表されます。次のうち最後の 5 つは元号記号で、日本の元号を表す代替記号として使用します。

中国語、日本語および韓国語の日付シンボル

説明

DDD

当該ロケールで月の日を表す漢数字

DDDD

当該ロケールで月の日を表す漢数字(「十」表記)

YYY

当該ロケールで年を表す漢数字

YYYYY

当該ロケールで年を表す漢数字(「十」表記)

g

当該ロケールの元号。このパターンでは、現在の日本の元号「平成」に対しては ASCII 文字の「H」(U+48)が表示されます。

gg

当該ロケールの元号。このパターンでは、現在の日本の元号に対しては Unicode の 1 文字(U+5E73)が表示されます。

ggg

当該ロケールの元号。このパターンでは、現在の日本の元号に対しては Unicode の複数文字(U+5E73 U+6210)が表示されます。

g

当該ロケールの元号。このパターンでは、現在の日本の元号に対しては全角文字の「H」(U+FF28)が表示されます。

g g

当該ロケールの元号。このパターンでは、現在の日本の元号に対しては Unicode の 1 文字(U+337B)が表示されます。

時間シンボル

説明

ロケールに依存する入力値

ロケールが英語(米国)の形式設定された値

h

時間(12 時間制)を 1 桁または 2 桁の数値(1 ~ 12)で表します。

12:08 AM または 2:08 PM

12 または 2

hh

時間(12 時間制)を 2 桁の数値(01 ~ 12)で表します。

12:08 AM または 2:08 PM

12 または 02

k

時間(12 時間制)を 1 桁または 2 桁の数値(0 ~ 11)で表します。

12:08 AM または 2:08 PM

0 または 2

kk

時間(12 時間制)を 2 桁の数値(00 ~ 11)で表します。

12:08 AM または 2:08 PM

00 または 02

H

時間(24 時間制)を 1 桁または 2 桁の数値(0 ~ 23)で表します。

12:08 AM または 2:08 PM

0 または 14

HH

時間(24 時間制)を 2 桁の数値(00 ~ 23)で表します。

12:08 AM または 2:08 PM

00 または 14

K

時間(24 時間制)を 1 桁または 2 桁の数値(1 ~ 24)で表します。

12:08 AM または 2:08 PM

24 または 14

KK

時間(24 時間制)を 2 桁の数値(01 ~ 24)で表します。

12:08 AM または 2:08 PM

24 または 14

M

分を 1 桁または 2 桁の数値(0 ~ 59)で表します。

注意: このシンボルを時間シンボルで使用する必要があります。

2:08 PM

8

MM

分を 2 桁の数値(00 ~ 59)で表します。

注意: このシンボルを時間シンボルで使用する必要があります。

2:08 PM

08

S

秒を 1 桁または 2 桁の数値(0 ~ 59)で表します。

注意: このシンボルを時間と分のシンボルで使用する必要があります。

2:08:09 PM

9

SS

秒を 2 桁の数値(00 ~ 59)で表します。

注意: このシンボルを時間と分のシンボルで使用する必要があります。

2:08:09 PM

09

FFF

1000 分の 1 秒を 3 桁の数値(000 ~ 999)で表します。

注意: このシンボルを時間、分、秒のシンボルで使用する必要があります。

2:08:09 PM

09

A

午前零時から正午まで(AM)または正午から午前零時まで(PM)で表します。

2:08:09 PM

PM

z

ISO-8601 タイムゾーン形式(例えば、Z、+0500、-0030、-01、+0100)。

注意: このシンボルを時間シンボルで使用する必要があります。

2:08:09 PM

-0400

zz

別の ISO-8601 タイムゾーン形式(例えば、Z、+05:00、-00:30、-01、+01:00)。

注意: このシンボルを時間シンボルで使用する必要があります。

2:08:09 PM

-04:00

Z

タイムゾーン名の略称(例:GMT、GMT+05:00、GMT-00:30、EST、PDT)

注意: このシンボルを時間シンボルで使用する必要があります。

2:08:09 PM

EDT

予約済みの記号

以下の記号は特別な意味を持つので、リテラルテキストとしては使用できません。

記号

説明

?

送信する場合、この記号は何らかの 1 文字に対応します。表示のために結合する場合はスペースになります。

*

送信する場合、この記号は 0 または Unicode の空白文字に対応します。表示のために結合する場合はスペースになります。

+

送信する場合、この記号は 1 つ以上の Unicode の空白文字に対応します。表示のために結合する場合はスペースになります。

ロケール

サポート対象の言語のリストについては、「Using Designer(Designer の使用法)」ガイドで「ロケール」のトピックを参照してください。