日付と時刻の値
値式を使用することで、仕様に基づいて実行時に動的な値を自動生成することができます。重要なプロセスを自動化し、テスト設計やメンテナンスの手間を軽減するのに役立ちます。
日付と時刻の値を生成するには、以下の式から選択します。
-
現在の日付/時刻の式はテストランの実際の日付/時刻に基づいて値を生成します。実際の日付がテストにとって重要な場合は、この式を使用してください。例えばトラッキングのためにタイムスタンプを作成する場合です。
-
計算された日付/時刻の式はテストランの実際の日付または指定された日付に基づいて架空の日付を生成します。テストに現在の日付を使用することが適さない場合は、この式を使用します。例えばXヶ月先の日付が必要なフィールドに値を入力するために使用します。
-
この二つの組み合わせにより、架空の日付が計算され、テストランの時の現在の日付であるかのように扱われます。テストランの実際の日付ではなく、現在の日付/時間式を使用したい場合は、この値を使用します。例えば、アプリケーションのタスク処理のテストを実行する場合に使用します。
現在の日付/時刻を使用する
テストランの実際の日付/時刻に基づいた値を生成するには、{Base command}または{Prefix command}の構文を使用してください。
-
{Base command}を利用可能な任意のベースコマンドに置き換えてください。
-
{Prefix command}を利用可能な任意のプレフィックスコマンドに置き換えてください。これらのタイプのコマンドでは、基本コマンドのDAY、MONTH、YEAR、DATEを使用して生成する値を変更します。
基本コマンドについては、以下のオプションのいずれかを選択します。
|
コマンド |
説明 |
|---|---|
|
ddの形式で完全な日付MM.yyyy |
|
|
TIME |
ミリタリータイム形式(HH:mm )の現在時刻 |
|
DATETIME |
yyyyMMddHHmmssの形式のタイムスタンプ |
|
DAY |
現在の日 |
|
MONTH |
現在の月 |
|
YEAR |
現在の年 |
|
MONTHFIRST |
現在の月の最初の日。形式は次のものを使用。dd.MM.yyyy |
|
MONTHLAST |
現在の月の最終日。形式は次のものを使用。dd.MM.yyyy |
|
QUARTERFIRST |
現在の四半期の初日。形式は次のものを使用。dd.MM.yyyy |
|
TRIMESTERFIRST |
現在のトリメスターの初日。形式は次のものを使用。dd.MM.yyyy |
|
HYEARFIRST |
現在の半期の初日。形式は次のものを使用。dd.MM.yyyy |
プレフィックスコマンドについては、以下のオプションから一つ選択します。
|
コマンド |
説明 |
|---|---|
|
LDAY |
ワークステーションの地域設定で指定した言語での曜日の正式名称(非省略形)。 |
|
LMONTH |
ワークステーションの地域設定で指定した言語での月の正式名称(非省略形)。 |
|
最終年 |
年(4桁)。 |
|
NDAY |
現在の日付の値(2桁)。先頭にゼロが付いた 1 桁の結果を返します。 |
|
NMONTH |
現在の月の値(2桁)。先頭にゼロが付いた1桁の結果を返します。 |
|
NYEAR |
現在の年の値(2桁)。先頭にゼロが付いた1桁の結果を返します。 |
|
ADAY |
ワークステーションの地域設定で指定した言語での曜日の略称。 |
|
AMONTH |
ワークステーションの地域設定で指定した言語における月の略称。 |
現在の日付/時刻の値を生成するための基本コマンドです。
テストランの日は2025年6月8日としましょう。時刻は3:09PM です。
この場合、以下の式は次の値を生成します。
-
{DATE}は08.06.2025を生成します。
-
{MONTH}は6を生成します。
-
{DATETIME}は20250608150900を生成します。
-
{TRIMESTERFIRST}は01.05.2025を生成します。
現在の日付/時間の値を生成するためのプレフィックスコマンドです。
上記の例の日付/時間をそのまま使用しましょう。ワークステーションの地域設定で指定した言語は英語であるとします。
この場合、以下の式は次の値を生成します。
-
{NMONTH}は06を生成します。
-
{LYEAR}は2025を生成します。
-
{ADAY} はSunを生成します。
計算された日付/時間を使用してください。
架空の日付を生成するには、次の構文を使用してください。{DATE[Basedate][Offset][Format]}:
-
Basedateを特定の日付/時間に置き換えるか、テストランの実際の日付を使用するためにパラメータを空のままにしてください。特定の日付/時間を追加する場合は、標準のDATE形式を必ず使用します。
-
Offsetを希望する基準日からの偏差に置き換えてください。
-
Formatを希望する生成された値の日付形式に置き換えるか、標準のDATE形式を使用するためにパラメータを空のままにしてください。
オフセットは、次の要素で構成されます。+または-が1つ、数字が1つ、そして時間の単位。
時間の単位については、次のオプションのいずれかを選択してください。
|
オフセットの単位 |
説明 |
|---|---|
|
d |
土曜日と日曜日を含む日 |
|
w |
月曜日から金曜日までの平日 |
|
M |
月 |
|
y |
年 |
|
h |
時間 |
|
m |
分 |
|
s |
秒 |
現在の日付に基づいてデフォルトの形式で値を生成します。
本日が2024年2月7日水曜日であるとします
この場合、{DATE[][+4d][]}という式は11.02.2024という値を生成します。
-
Basedateパラメーターが空であるため、Tosca Cloud は現在の日付を取得して4日を加えます。
-
Formatパラメーターが空であるため、Tosca Cloud は標準のDATE形式を使用します。
現在の日付に基づいて、特定の形式で値を生成します。
引き続き2024年2月7日水曜日の例を使用しましょう。時間は5:00PMだとしましょう。
この場合、{DATE[][+4w-5h][yyyyMMddHHmm]} という式は 202402131200という値を生成します。
-
Basedateパラメーターが空であるため、Tosca Cloud は現在の日付を取得し、4営業日を加算し、5時間を差し引きます。
-
Tosca Cloud は、生成された日付をFormatパラメータに従ってフォーマットします。
所定の日付に基づいて特定のフォーマットで値を生成します。
{DATE[01.03.2024][-1y+1M][MM/dd/yy]} という式は 04/01/23という値を生成します。
-
Tosca Cloud は、Basedateパラメータの日付を使用して、1年を引いて1ヶ月を加えます。
-
Tosca Cloud は、生成された日付をFormatパラメータに従ってフォーマットします。
日付/時刻の組み合わせを使用してください。
架空の日付をテストランの現在の日付として扱うために値を生成する場合は、構文、{Current date command[{DATE[Basedate][Offset][Format]}]}を使用します。
日付/時刻の組み合わせコマンドを使用してください。
今日が2024年3月1日だとします。
計算された日付の月を2桁で返す式を作成します。{NMONTH[{DATE[][+2M][]}]}と入力します。
-
DATE構文の結果は01.05.2024です。
-
現在の日付コマンドNMONTHはこの結果を現在の日付として使用し、月、05を返します。
日付形式および時刻形式を理解する
デフォルトでは、Tosca Cloud は、以下の形式で日付と時刻の値を作成します。dd.MM.yyyy, HH:mm, yyyyMMddHHmmss
デフォルトの値を変更するには、テストケース内で以下の特別なタスクパラメータを使用することができます。ToscaDateFormat, ToscaTimeFormat, ToscaDateTimeFormat.