日時の形式

日時関連のアクションでは、さまざまな日時の表記を使用することができます。
この章では、日時の表記形式について説明します。

日時

詳細は後述しますが、たとえば出力では以下のような表記が使用できます。

• 2020-04-01T20:07:42+0900
• Wed, 01 Apr 2020 20:07:42 +0900
• 2020年4月1日 20:07
• 明日
• 1時間前

また、入力では前述の形式に加え、以下のような幅広い表記が使用できます。
ただし後述のように、バグの元にもなるため注意が必要です。

出力形式

日付型変数・間隔型変数の値を出力する際には、指定した出力形式にすることができます。
アクションに入力したマジック変数（日付型変数・間隔型変数）をタップすると、画面下部にピッカーが現れるので、そこで表示形式を指定します。
なお「時間フォーマット」のみを「カスタムフォーマット」にすることはできないため、「日付フォーマット」の項で「カスタムフォーマット」を指定し、「文字列をフォーマット」の項で日付と時刻をまとめて指定してください。

出力形式は、次の通りです。

日付フォーマット

時間フォーマット

「日付フォーマット」が「RFC 2820」のときは、指定できません。

カスタム

カスタムフォーマットで書式指定子を使うと、出力形式を任意のものに設定することができます。
ショートカットApp内のアクションの説明では、「Unicode Technical Standard #35 “Unicode Locale Data Markup Language (LDML)”」の“Part 4: Dates”のFormat Patterns（リンク先は英語）に従っていると書かれていますが、その書式指定子のすべてに対応しているわけではありません。

ここでは主なものを紹介します。
なお出力は西暦のみで、和暦などを出力することはできません。
またカスタムフォーマットの中で書式指定子と同じ文字を使用する場合は、シングルクォート（'）で囲むとエスケープすることができます。

※日付型変数はショートカットApp内部ではNSDateクラスとして扱われているため、カスタムフォーマットの書式はNSDateFormatterクラスと同じ書式です。
ただし和暦には対応していないなどの違いがあり、完全に同一ではないようです。

日時表記の注意点

入力形式については、前述のように自由度が非常に高くなっています。
それがゆえに、きちんと仕様を理解していないと、これがバグの原因になることがあります。
以下のような不具合を予防するため、RFC 2820, ISO 8601形式などのような規格で定められた日時表記の使用を、おすすめします。

特に注意が必要なものとしては、以下があります。

• 日付を省略したり、日付の指定方法に誤りがある場合は、エラーにならずに今日の日付が設定されます。
  
• 日付で年を省略した場合は、今年になります。
  
• 時刻を省略したり、時刻の表記に誤りがある場合は、エラーにならずに午前12:00に設定されます。
  
• 入力する時刻が1～11時台だった場合、12時間制で指定したものだと認識されてしまうことがあります。
  なお指定した時刻が現在時刻よりも前の場合は、現在よりも後の時刻だと判断します。
  （※午前7:00に6:00と指定した場合、午前7:00の次にくる6:00、つまり午後6:00だと判断します。）
  そのため「午前」・「AM」・「朝」などを付加して誤認識を避けることをおすすめします。
  
• タイムゾーンを指定しない場合は、日本標準時になります。
• 相対表記の表現に誤りがあると、誤った日時に設定されることがあります。
  そのため、相対表記の使用はおすすめできません。
  

またこれ以外の有名な事例では、日本では日付は年/月/日と表記しますが、アメリカでは月/日/年、ヨーロッパでは日/月/年という表記が主流であるため、海外の日付表記をそのまま入力すると、誤った日付になってしまうことがあります。

相対表記

macOSと同様に、相対表記も入力・出力で使用することができます。
ただし曜日・時制・時間・時差の解釈で勘違いが起きたり、記述ミスがあると誤った日時に設定されてしまったり、日付をまたいだときに不都合が生じることがあります。
そのため、相対表記の使用はおすすめしません。
なおこれらの表記は、Common Locale Data Repository (CLDR)のLocale Data Summary に準拠しているようです。

出力形式

この節では、間隔型変数の出力で使用できる相対表記を紹介します。
日付型変数で使用した場合、現在の日時との差を相対表記で出力します。

プロパティ「日付」が「相対」の場合

日時の範囲が下記以外の場合は、相対表示ではなく日付が出力されます。

• 一昨日
• 昨日
• 今日
• 明日
• 明後日

プロパティ「日付」が「経過時間/終了までの時間」の場合

入力形式

この節では、日付型変数・間隔型変数の入力で使用できる、相対表記を紹介します。
下記のほか、前述の出力形式の表記も使用できます。
なお相対表記の全貌を把握できていないため、ここでは筆者の検証で確認できたものだけを紹介します。

日単位

時刻を指定しない場合は午前12:00に、タイムゾーンを指定しない場合は日本標準時（GMT+09:00）に設定されます。

• 昨日・きのう
• 今日・今
• 明日・あす・あした
• 今週○曜日・今週○曜
• ○曜日・○曜
  当日がその曜日であれば、翌週のその曜日の日付になります。
  ※これは英語圏由来の概念で、日本の考え方とは違うので注意が必要です。
  
• 来週○曜日・来週○曜

時間単位

●●には、昨日・今日などの、日単位の相対表記が入ります。
日付の相対単位を使わない場合、日付は今日になります。
なお時刻が1～11時台の場合、12時間制だと認識されてしまうため、アクションを実行した時刻により午前・午後のどちらかに自動で決定されます。
これを避けるには、午前・AMなどを付加してください。

• ○時○分○秒
  今日の、指定された時刻になります。
  ○時半という表記も使えます。
  
• ●●　○時○分○秒・●●○時○分○秒・●●の○時○分○秒
  指定された日の、指定された時刻になります。
  ただし時が1～11で、なおかつ午後・PMなどが記載されていない場合は、12時間制だと解釈されるため、アクションを実行するタイミングにより午前・午後のどちらかになります。
  
• ▲　○時○分○秒・▲○時○分○秒・▲の○時○分○秒
  今日・明日の、指定され時刻になります。
  ▲には、朝・昼・夕方・夜・午前・午後が入ります。
  12時間制で指定する際、午前・午後を明確化するために使います。
  
• ●●　朝・●●朝・●●の朝
  指定された日の9:00になります。
• ●●　昼・●●昼・●●の昼
  指定された日の12:00になります。
• ●●　▲・●●▲・●●の▲・今夜・今晩
  指定された日の18:00になります。
  ▲には、夕方・夜・晩が入ります。
  
• 昨夜・前夜
  前日の19:00になります。
  ※「今晩」・「今夜」とは時刻が異なります。

UNIX時間

これらの他によく使われている日時表記の一つに、UNIX時間(UNIX Time)があります。
iOSの内部でもUNIX時間は使われているのですが、ショートカットAppではこれを直接入力・出力する方法がありません。
しかし、ひと手間かけることでUNIX時間を入力・出力することができます。
詳細は、Tips＆FAQのページを参照してください。