変数構成要素と変数型
変数が何でできているかと、データ型ごとの値の決め方を説明します。ローカル変数と共通変数で、入れるものは同じです。
変数の構成要素
- 変数名必須
- 使うときに書く名前。英数字とアンダースコア（
_）だけで、先頭に数字は置けません。255 文字まで。 - データ型必須
- 文字列・数値・日付・日付時間・時間の 5 つから選びます。選び直すと、値と形式の指定はいったん空に戻ります。
- 変数の値必須
- 入れ方はデータ型で変わります。文字列と数値は直接入力、残り 3 つは指定方法を選びます。255 文字までです。
- 変数の説明
- 用途などを自由に書けます。1000 文字まで。空のままでも作れます。
文字列型・数値型の値
入力した値がそのまま変数の値になります。数値型では、数値として読めない文字を入れると保存できません。
日付型・日付時間型・時間型の値
この 3 つでは、まず指定方法を選びます。選んだ指定方法によって、次に入れるものが変わります。
- よく使う値から選ぶ
- 決まった選択肢から選びます。実行するたびに、その時点の値が入ります。
- 相対で決める
- 起点から「◯◯ を加算・減算」の形で決めます。こちらも実行するたびに値が変わります。
- 固定で入力する
- 値そのものを入力します。いつ実行しても値は変わりません。
画面に出る名前はデータ型で変わります。
| データ型 | 欄の名前 | 選べる 3 つ |
|---|---|---|
| 日付 | 日付の指定方法 | よく使う日付を指定 / 相対日付を指定 / 固定日付を入力 |
| 日付時間 | 日付時間の指定方法 | よく使う日付時間を指定 / 相対日付時間を指定 / 固定日付時間を入力 |
| 時間 | 時間の指定方法 | よく使う時間を指定 / 相対時間を指定 / 固定時間を入力 |
入れられるものもデータ型ごとに違います。
| データ型 | よく使う値の選択肢 | 相対指定の起点 | 相対指定で使える単位 | 固定入力の形 |
|---|---|---|---|---|
| 日付 | 今日 / 昨日 / 7 日前 / 3 ヶ月前 / 半年前 / 1 年前 | 今日から | 年・月・日 | yyyy-MM-dd |
| 日付時間 | 現在時刻 | 現在時刻から | 年・月・日・時間・分・秒 | yyyy-MM-dd HH:mm:ss |
| 時間 | 現在時刻 | 現在時刻から | 時間・分・秒 | HH:mm:ss |
相対指定の数は、1 以上の整数だけ入れられます。「加算」と「減算」はそれぞれ別に選びます。
値が変わる例
2023 年 1 月 1 日に作った変数を、1 月 5 日に使うとこうなります。
| 指定方法 | 作った日（1 月 1 日）の値 | 4 日後（1 月 5 日）の値 |
|---|---|---|
| よく使う日付を指定（今日） | 2023-01-01 | 2023-01-05 |
| 相対日付を指定（今日から 1 年を減算） | 2022-01-01 | 2022-01-05 |
| 固定日付を入力（2023-01-01） | 2023-01-01 | 2023-01-01 |
つまり、前の 2 つは日が経つと値も動きます。これを使うと、「いつも直近 1 年分」のような絞り込みを、設定を直さずに続けられます。
値の形
日付・日付時間・時間の変数では、形式の選択が必須です。同じ「今日」でも、選んだ形で書き出される文字が変わります。
選べる形式
| データ型 | 選べる形式 |
|---|---|
| 日付 | YYYY-mm-dd / YYYY/mm/dd / YYYYmmdd / YYYY年mm月dd日 / YYYY-mm / YYYY ※年 / mm ※月 / dd ※日 / 自分で設定する |
| 日付時間 | YYYY-mm-dd HH:MM:SS / YYYY/mm/dd HH:MM:SS / YYYYmmddHHMMSS / YYYY年mm月dd日 HH時MM分SS秒 / YYYY-mm-dd / YYYY-mm / YYYY ※年 / mm ※月 / dd ※日 / HH ※時 / MM ※分 / SS ※秒 / 自分で設定する |
| 時間 | HH:MM:SS / HH時MM分SS秒 / HH ※時 / MM ※分 / SS ※秒 / 自分で設定する |
※ が付いたものは、その要素だけを取り出します。YYYY ※年 なら「2023」、mm ※月 なら「01」になります。
自分で設定するを選ぶと入力欄が出ます。書き方は日付フォーマットの仕様にあります。
タイムゾーン
「よく使う日付を指定」と「相対日付を指定」では、どこの時刻を基準に計算するかを選べます。「固定日付を入力」では計算が要らないので、この欄は出ません。
何も触らなければ組織のタイムゾーンで計算されます。別の地域に合わせたいときだけ、「組織のデフォルトタイムゾーンを使用」のチェックを外して選び直します。たとえば America/New_York にすると、「今日」はニューヨークでの今日の日付になります。
選べるタイムゾーン（41 件）
| タイムゾーン | UTC からのずれ |
|---|---|
| UTC | (UTC+00:00) |
| Pacific/Honolulu | (UTC-10:00) |
| America/Anchorage | (UTC-09:00) |
| America/Los_Angeles | (UTC-08:00) |
| America/Vancouver | (UTC-08:00) |
| America/Denver | (UTC-07:00) |
| America/Phoenix | (UTC-07:00) |
| America/Chicago | (UTC-06:00) |
| America/Mexico_City | (UTC-06:00) |
| America/Bogota | (UTC-05:00) |
| America/Lima | (UTC-05:00) |
| America/New_York | (UTC-05:00) |
| America/Toronto | (UTC-05:00) |
| America/Argentina/Buenos_Aires | (UTC-03:00) |
| America/Sao_Paulo | (UTC-03:00) |
| Europe/London | (UTC+00:00) |
| Europe/Paris | (UTC+01:00) |
| Africa/Cairo | (UTC+02:00) |
| Africa/Johannesburg | (UTC+02:00) |
| Europe/Athens | (UTC+02:00) |
| Europe/Istanbul | (UTC+03:00) |
| Europe/Moscow | (UTC+03:00) |
| Asia/Tehran | (UTC+03:30) |
| Asia/Dubai | (UTC+04:00) |
| Asia/Kolkata | (UTC+05:30) |
| Asia/Bangkok | (UTC+07:00) |
| Asia/Jakarta | (UTC+07:00) |
| Asia/Hong_Kong | (UTC+08:00) |
| Asia/Kuala_Lumpur | (UTC+08:00) |
| Asia/Manila | (UTC+08:00) |
| Asia/Shanghai | (UTC+08:00) |
| Asia/Singapore | (UTC+08:00) |
| Asia/Taipei | (UTC+08:00) |
| Australia/Perth | (UTC+08:00) |
| Asia/Seoul | (UTC+09:00) |
| Asia/Tokyo | (UTC+09:00) |
| Australia/Adelaide | (UTC+09:30) |
| Australia/Brisbane | (UTC+10:00) |
| Australia/Sydney | (UTC+10:00) |
| Pacific/Auckland | (UTC+12:00) |
| Pacific/Fiji | (UTC+12:00) |