日付、時刻、数字、その他 フォーマット設定

月の日を1から31までの数値として表します：27。

1桁の日は、先行ゼロなしでフォーマットされます：3。

単独で使用する場合は、前に%を付けます。

月の日を01から31までの数値として表します：27。

1桁の日は、先行ゼロを付けてフォーマットされます：03。

月を1から12までの数値として表します：11。

1桁の月は、先行ゼロなしでフォーマットされます：5。

単独で使用する場合は、前に%を付けます。

月を01から12までの数値として表します：11。

1桁の月は、先行ゼロを付けてフォーマットされます：05。

年を1桁または2桁の数字で表します：23。

年が2桁を超える場合、結果には下位2桁のみが表示されます。例えば、2023年は23と表示されます。

2桁の年の最初の桁がゼロで始まる場合（例えば02）、数値は先行ゼロなしでフォーマットされます：2。

年を2桁の数字で表します：23。

年が2桁を超える場合、結果には下位2桁のみが表示されます。例えば、2023年は23と表示されます。

2桁の年の有効数字が2桁未満の場合、2桁になるように、数値には先行ゼロが埋め込まれます：02。

単独で使用する場合は、前に%を付けます。

3桁以上の年を表します：2023。

年に有効数字が3桁を超える場合、それらは結果文字列に含まれます。年の桁数が3桁未満の場合は、3桁になるように、数値に先行ゼロが埋め込まれます。

メモ：5桁の年が可能なタイの仏暦の場合、このフォーマット指定子は5桁すべてを表示します。

年を4桁の数字で表します：2023。

年が4桁を超える場合、結果には下位4桁のみが表示されます。年の桁数が4桁未満の場合は、4桁になるように、数値に先行ゼロが埋め込まれます。

メモ：5桁の年が可能なタイの仏暦の場合、このフォーマット指定子は5桁すべてを表示します。

年を5桁の数字で表します。

年が5桁を超える場合、結果には下位5桁のみが表示されます。年の桁数が5桁未満の場合は、5桁になるように、数値に先行ゼロが埋め込まれます：02023。

y指定子の数が6以上ある場合、y指定子の数を達成するために必要な数の先行ゼロが数値に埋め込まれます。例えば、8つのy指定子がある場合、出力は00002023となります。

A.D.などの時代や年代を表します。フォーマットする日付に時代や年代の文字列が関連付けられていない場合、スクリプトはこの指定子を無視します。

gを単独で使用することはできません。時代名や年代名だけを出力したい場合は、ggのように2つ使用します。

時間を12時間制で1から12までの数値として表します。これは午前0時または正午からの時間数をカウントします。

真夜中からの特定の時間は、正午からの同じ時間と区別できません。例えば、「1:00 AM」は「1:00 PM」と同じです。

時間は丸められず、1桁の時間は先行ゼロなしでフォーマットされます。

単独で使用する場合は、前に%を付けます。

例えば、5:43という時刻が指定された場合、このカスタムフォーマット指定子での表示は5となります。

時間を12時間制で01から12までの2桁の数値として表します。これは午前0時または正午からの時間数をカウントします。

真夜中からの特定の時間は、正午からの同じ時間と区別できません。例えば、「1:00 AM」は「1:00 PM」と同じです。

時間は四捨五入されず、1桁の時間は先行ゼロでフォーマットされます。

例えば、5:43という時刻が指定された場合、このカスタムフォーマット指定子での表示は05となります。

時間を0から23までの数値として表します。これは真夜中からの時間をカウントする24時間時計による時間です。

1桁の時間は、先行ゼロなしでフォーマットされます。

例えば、5:43 PMという時刻が指定された場合、このカスタムフォーマット指定子での表示は17となります。

単独で使用する場合は、前に%を付けます。

時間を00から23までの2桁の数値として表します。これは真夜中からの時間をカウントする24時間時計による時間です。

1桁の時間は、先行ゼロでフォーマットされます。

例えば、5:43 PMという時刻が指定された場合、このカスタムフォーマット指定子での表示は17となります。

分を0から59までの数値として表します。

分は、最後の1時間から経過した分全体を表します。1桁の分は、先行ゼロなしでフォーマットされます。

例えば、5:43:34という時刻が指定された場合、このカスタムフォーマット指定子での表示は43となります。

単独で使用する場合は、前に%を付けます。

分を00から59までの2桁の数値として表します。

分は、最後の1時間から経過した分全体を表します。1桁の分は、先行ゼロでフォーマットされます。

例えば、5:03:34という時刻が指定された場合、このカスタムフォーマット指定子での表示は03となります。

秒を0から59までの数値として表します。

結果は、最後の1分から経過した秒全体を表します。1桁の秒は、先行ゼロなしでフォーマットされます。

例えば、5:43:04という時刻が指定された場合、このカスタムフォーマット指定子での表示は4となります。

単独で使用する場合は、前に%を付けます。

秒を00から59までの2桁の数値として表します。

結果は、最後の1分から経過した秒全体を表します。1桁の秒は、先行ゼロでフォーマットされます。

例えば、5:43:04という時刻が指定された場合、このカスタムフォーマット指定子での表示は04となります。

秒の小数点以下の桁数を表す。小文字のf指定子は、末尾のゼロを含めます。大文字のFは、末尾のゼロを取り除きます。

この指定子は、OLEオートメーション 日付を浮動小数点整数で記述する方法。1899年12月30日からの日数を示す。の日付/時刻でのみ動作します。

fまたは Fの文字数によって、小数点以下の表示される有効な桁数が決まります。

• F：10分の1秒、または小数点以下1桁。この桁がゼロの場合は何も表示されません。
• ffまたはFF：100分の1秒、または小数点以下2桁。
• fffまたはFFF：1000分の1秒、または小数点以下3桁。これはミリ秒とも呼ばれます。
• ffffまたはFFFF：1万分の1秒、または小数点以下4桁。
• fffffまたはFFFFF：10万分の1秒、または小数点以下5桁。
• ffffffまたはFFFFFF：100万分の1秒、または小数点以下6桁。
• FFFFFFF：1000万分の1秒、または小数点以下7桁。

指定する精度が高ければ高いほど、信頼性や意味が損なわれる可能性があります。時刻の値の精度は、コンピューターのシステムクロックの分解能によって異なります。

AM/PM指定子の最初の文字を表します。AM指定子は、フォーマットされる時間の時間が12未満の場合に使用されます。それ以外の場合は、PM指定子が使用されます。

最初の文字が同じで2番目の文字が変わるAM/PM指定を使用する言語には、tt指定子を使用します。

単独で使用する場合は、前に%を付けます。

AM/PM指定子を表します。AM指定子は、フォーマットされる時間の時間が12未満の場合に使用されます。それ以外の場合は、PM指定子が使用されます。

日本語のように最初の文字が同じで2番目の文字が異なるAM/PM指定を使用する言語にはtt指定子を使用します。

協定世界時（UTC）からのローカルオペレーティングシステムのタイムゾーンの符号付きオフセットを表します。z文字の数は、表示されるオフセットの単位を定義します。

• z、zz：オフセットを時間で計測します。
• zzz：オフセットを時間と分で計測します。

オフセットは常に先頭記号で表示されます。プラス記号（+）は、時間がUTCより進んでいることを示し、マイナス記号（-）は、UTCより遅れていることを示します。オフセットの範囲は–12〜 +13です。1桁のオフセットは、先行ゼロでフォーマットされます。

単独で使用する場合は、前に%を付けます。

数値は、通貨の金額を表す文字列に変換されます。フォーマット指定子に、数値の小数点以下桁数を示す数字を含めて指定します。フォーマット指定子が大文字か小文字かは結果に影響しません。

ASSIGN StringVal = "0013001.93912837"
ASSIGN CurrencyResult = "{StringVal.format('C')}"
ASSIGN CurrencyResult3 = "{StringVal.format('C3')}"

結果：

CURRENCYRESULT=$13,001.94

CURRENCYRESULT3=$13,001.939

E0

E-0

e0

e+0

e-0

数値は-d.ddd…E+dddまたは-d.ddd…e+dddのフォーマットの文字列に変換されます。ここで各dは1桁の数字（0〜9）を示します。数値が負の場合、文字列はマイナス記号で始まります。常に小数点の前に1桁があります。

出力の小数点以下桁数を指定する場合は、フォーマット指定子に数字を含めます。精度指定子を使用しない場合、スクリプトはデフォルトで小数点以下6桁を使用します。

フォーマット指定子が大文字か小文字かは、出力の指数の前にEとeのどちらを付けるかを示します。指数は常にプラスまたはマイナス記号と最低3桁で構成されます。必要に応じて、この最小値を満たすために指数にゼロが埋め込まれます。

文字列E、E+、E-、e、e+、またはe-のいずれかがフォーマット文字列に存在し、直後に少なくとも1つの0文字が続く場合、数値は、数値と指数の間にEまたはeが挿入された科学的記数法を使用してフォーマットされます。

科学的記数法の指標に続く0文字の数は、指数に対して出力する最小桁数を決定します。E+およびe+のフォーマットは、指数の前に常に符号文字（プラスまたはマイナス）が必要であることを示します。E、E-、e、またはe-のフォーマットは、符号文字が負の指数の前にのみ必要であることを示します。

 ASSIGN StringVal = "0013001.93912837"
ASSIGN ScientificResult = "{StringVal.format('e')}"		
ASSIGN ScientificResult = "{StringVal.format('E2')}"	

結果：

SCIENTIFICRESULT=1.300194e+004

SCIENTIFICRESULT2=1.300194E+004

数値は-ddd.ddd…形式の文字列に変換されます。各dは1桁の数字（0〜9）を示します。数値が負の場合、文字列はマイナス記号で始まります。

フォーマット指定子に、結果の小数点以下桁数を示す数字も含めて指定します。精度指定子を使用しない場合、スクリプトはデフォルトで小数点以下2桁を使用します。

ASSIGN StringVal = "0013001.93912837"
ASSIGN FixedPointResult = "{StringVal.format('F3')}"
ASSIGN FixedPointResult2 = "{StringVal.format('f')}"

結果：

FIXEDPOINTRESULT=13001.939

FIXEDPOINTRESULT2=13001.94

数値は、数値のタイプと精度指定子の有無に応じて、固定小数点表記または科学的記数法の最もコンパクトな方法で変換されます。精度指定子が省略されているかゼロの場合、次のリストに示すように、数値のタイプによってデフォルトの精度が決まります：

• バイトまたはSバイト：3
• Int16またはUInt16：5
• Int32またはUInt32：10
• Int64またはUInt64：19
• シングル：7
• ダブル：15
• 10進数：29

数値を科学的記数法で表現した結果の指数が-5より大きく、精度指定子よりも小さい場合は、固定小数点表記が使用されます。それ以外の場合は、科学的記数法が使用されます。結果には、必要に応じて小数点が含まれ、後続のゼロは省略されます。

精度指定子が存在し、結果の有効桁数が指定された精度を超える場合、余分な末尾の桁は丸めによって削除されます。上記の規則の例外は、数値が10進数であり、精度指定子が省略されている場合です。その場合、固定小数点表記が常に使用され、末尾のゼロが保持されます。

科学的記数法が使用されている場合、結果の指数には、フォーマット指定子がGの場合はE、フォーマット指定子がgの場合はeが接頭辞として付けられます。

ASSIGN StringVal = "0013001.93912837"
ASSIGN GeneralResult1 = "{StringVal.format('G')}"
ASSIGN StringVal2 = 6002348902348890234.234432234
ASSIGN GeneralResult2 = "{StringVal2.format('G')}"

結果：

GENERALRESULT1=13001.93912837

GENERALRESULT2=6.00234890234889E+18

この形式は、整数型でのみサポートされています。数値は16進数の文字列に変換されます。フォーマット指定子の大文字と小文字は、9より大きい16進数に大文字と小文字のどちらを使用するかを示します。例えば、Xを使用してABCDEFを生成し、xを使用してabcdefを生成します。

精度指定子は、結果の文字列に必要な最小桁数を示します。必要に応じて、数値の左側にゼロが埋め込まれ、精度指定子によって指定された桁数が生成されます。

数値は-d,ddd,ddd.ddd…という形式の文字列に変換されます。ここで、

• マイナス記号（-）は、必要に応じて負の数記号を示します。
• 各dは、1桁の数字（0～9）を示します。
• カンマ（,） は、数値グループの3桁ごとの区切りを示します。
• ピリオド（.）は、小数点記号を示します。

精度指定子を指定して、結果に含める小数点以下の桁数を指定します。精度指定子が指定されない場合、デフォルトで小数点以下2桁が使用されます。数値に小数点が含まれていない場合、出力の数値に.00が加算されます。

ASSIGN StringVal = "0013001.93912837"
ASSIGN NumberResult = StringVal.format('N')
ASSIGN NumberResult2 = "{StringVal.format('n2')}"

結果：

NUMBERRESULT=13,001.94

NUMBERRESULT2=13,001.9391

数値はパーセントを表す文字列に変換されます。変換された数値は、パーセンテージで表示するために100を掛けられます。

精度指定子を指定して、結果に含める小数点以下の桁数を指定します。精度指定子が指定されない場合、デフォルトで小数点以下2桁が使用されます。数値に小数点が含まれていない場合、出力の数値に.00が加算されます。

ASSIGN StringVal = "0013001.93912837"
ASSIGN PercentResult = "{StringVal.format('P')}"
ASSIGN PercentResult2 = StringVal.format('P2')	

結果：

PERCENTRESULT=1,300,193.91%

PERCENTRESULT2=1,300,193.91%

この形式は、シングルタイプとダブルタイプでのみサポートされています。ラウンドトリップ指定子は、文字列に変換された数値が解析されて同じ数値に戻されることを保証します。この指定子を使用して数値をフォーマットする場合、最初に一般的なフォーマットを使用してテストされます。ダブルの場合は15スペース、シングルの場合は7スペースの精度です。値が正常に解析されて同じ数値に戻されると、一般的なフォーマット指定子を使用してフォーマットされます。ただし、値が正常に解析されて同じ数値に戻されない場合、値は、Doubleの場合は17桁の精度、Singleの場合は9桁の精度を使用してフォーマットされます。

精度指定子が存在する可能性はありますが、無視されます。この指定子を使用する場合、ラウンドトリップは精度よりも優先されます。

ASSIGN StringVal = "0013001.93912837"
ASSIGN RoundTripResult = "{StringVal.format('R')}"	

結果：

ROUNDTRIPRESULT=13001.93912837

1つ以上のゼロプレースホルダーを使用して、出力される数値の形式を定義します。このプレースホルダーは、この表で定義されている他のプレースホルダー文字と組み合わせることができます。

フォーマットする値のフォーマット文字列で0がある位置に数字がある場合、その数字は出力文字列に表示されます。フォーマット文字列で0がある位置に数字がない場合、出力文字列には代わりに0が表示されます。これは、数字の先頭にゼロが必要な場合、欠けているゼロを補うのに役立ちます。

小数点の前の左端の0と小数点の後の右端の0の位置によって、出力文字列に常に含まれる桁数が決まります。

00指定子を使用すると、値の小数点以下が四捨五入されます。

ASSIGN number = "2343456.2343"
ASSIGN zeroPlaceholders = "number.format(000,000.00)
ASSIGN number = "456.47"
ASSIGN doubleZeroSpecifier = number.format('00')

例の結果は

zeroPlaceholders = 2,343,456.23

doubleZeroSpecifier = 456

1つ以上の桁プレースホルダーを使用して、出力される数値の形式を定義します。このプレースホルダーは、この表で定義されている他のプレースホルダー文字と組み合わせることができます。

フォーマットされる値のフォーマット文字列に「#」がある位置に数字がある場合、その数字は出力文字列に表示されます。フォーマット文字列の「#」がある位置に数字がない場合、出力文字列ではその位置が空白になります。

フォーマットする数値の有効桁として0が含まれる場合、出力文字列には0が表示されます。0が有効桁ではない場合、フォーマットされる文字列の中で0が唯一の数字であっても、出力文字列には表示されません。

##フォーマット文字列を使用すると、値の小数点以下が四捨五入されます。

ASSIGN number = "2343456.2043"
ASSIGN digitPlaceholders = "number.format(###,###.##)
ASSIGN number = "456.47"
ASSIGN doubleDigitSpecifier = number.format('##')

例の結果は

digitPlaceholders = 2,343,456.2

doubleDigitSpecifier = 456

最初のピリオド（.）文字は、フォーマットされた値の小数点の位置を決定します。それ以降のピリオド文字は無視されます。

カンマ（,）文字は、千単位の区切り文字指定子と数値スケーリング指定子の両方として機能します。

千の区切り文字指定子：数値の整数部分をフォーマットする2桁のプレースホルダー（0または#）の間に1つ以上のカンマ（,）文字が指定されている場合、出力の整数部分の各数値グループの間にグループ区切り文字が挿入されます。例えば、文字列「#,#」とIvariantCultureを使用して1000という数値をフォーマットすると、出力は1,000になります。

数値スケーリング指定子：1つ以上のカンマ（,）文字が明示的または暗黙的な小数点のすぐ左に指定されている場合、フォーマットされる数値は、各数値スケーリング指定子ごとに1000で除算されます。例えば、文字列「0,,」を使用して1億という数値をフォーマットすると、出力は100になります。

同じフォーマット文字列で千の区切り文字と数値スケーリング指定子を使用できます。例えば、文字列「#,0,,」とInvariantCultureを使用して10億という数値をフォーマットすると、出力は1,000になります。

数値に対して2つまたは3つの可能なフォーマットオプションを定義することができます。数値が正、負、ゼロのいずれであるかに応じて、該当するフォーマットが適用されます。

フォーマット設定オプションは1つの文字列で定義されます。各オプションはセミコロン（;）で区切ります。以下の例に示すように、ゼロ、桁、千、小数のプレースホルダーを使って書式を定義します。これらのプレースホルダーについてはこの表に説明されています。

カスタムのフォーマット文字列に2つのセクションがある場合：

• 左のセクションは、正の数とゼロの数のフォーマットを定義します。
• 右のセクションは、負の数のフォーマットを定義します。

例：

ASSIGN number9 = 928374
ASSIGN sectionSeparator4 = number9.format('000,000.##;00.##')

ASSIGN number10 = -998822.25
ASSIGN sectionSeparator5 = number10.format('000,000.##;00.##')

ASSIGN number11 = 0
ASSIGN sectionSeparator6 = number11.format('000,000.##;00.##')	

例の結果は

sectionSeparator4 = 928,374

sectionSeparator5 = 998822.25

sectionSeparator6 = 000,000

3つのセクションがある場合：

• 左のセクションは、正の数のフォーマットを定義します。
• 中央のセクションは、負の数のフォーマットを定義します。
• 右のセクションは、ゼロの数のフォーマットを定義します。

例：

ASSIGN number1 = 1789789
ASSIGN sectionSeparator1 = number1.format('000,000.##;00.##;000.0000')

ASSIGN number2 = 0
ASSIGN sectionSeparator2 = number2.format('000,000.##;00.##;000.0000')

ASSIGN number3 = -4321
ASSIGN sectionSeparator3 = number3.format('000,000.##;00.##;000.0000')

例の結果は

sectionSeparator1 = 1,789,789

sectionSeparator2 = 000.0000

sectionSeparator3 = 4321

他のすべての文字

その他の文字は結果文字列にコピーされ、フォーマットには影響しません。

エスケープシーケンスを含む文字列の前にプレフィックスとして使用します。「$」文字は二重引用符の外に指定する必要があります。例：

z = $"Use the \{myVar} variable."

日付/時刻型として宣言する場合、値の前にプレフィックスとして使用します。「#」文字は二重引用符の外に指定する必要があります。例：

ASSIGN var = #"02/09/2023"