【AppSheet 基礎】 AppSheet 日時の取扱い方を解説！

AppSheet における日時の扱い

AppSheet における日時は、"YYYY/MM/DD" や  "MM/DD/YYYY"、"YYYY年MM月DD日"といったフォーマットに一致する文字列で、年・月・日の情報をもちます。日付型のデータはデフォルトでは "MM/DD/YY" のフォーマットで表示されます。

日時式の基本

日時式として扱うことができる定数の値は、日時として判定される文字列です。日時として判定されるかどうかは特定のフォーマットに一致しているかどうかが鍵となっています。フォーマットについては、こちらの記事を参照してください。

日時式の定数の値は、一致したフォーマットによって、日時 (DateTime) 型、日付 (Date) 型、時間 (Time) 型、期間 (Duration) 型の4種に分類することができます。型によって関数に入力する際の扱いや、画面に表示される際のデフォルトのフォーマットが異なります。表示する際のフォーマットを変更するには TEXT関数を利用します。

日時型は日付型と時刻型を、間にスペースを挟んで連結したもので、文字通り日付と時間両方の情報（年・月・日・時・分・秒）をもちます。日時型のデータはデフォルトでは "YYYY/MM/DD HH:MM:SS" のフォーマットで表示されます。

日付型は "YYYY/MM/DD" や  "MM/DD/YYYY"、"YYYY年MM月DD日"といったフォーマットに一致する文字列で、年・月・日の情報をもちます。日付型のデータはデフォルトでは "MM/DD/YY" のフォーマットで表示されます。

時刻型は "HH:MM:SS" や "HH時MM分" といったフォーマットに一致する文字列で、時・分・秒の情報をもちます。時刻型のデータはデフォルトでは "HH:MM:SS" のフォーマットで表示されます。

期間型は "HHH:MM:SS" や "D.HHH:MM:SS" のフォーマットに一致する文字列です。時刻型に似ていますが H の項が3桁になっている点が特徴です。日数の項は省略することができますが、秒数の項は省略できません。

以下に日時式の定数の値の例を示します。表で示すように、年月日時分秒の一部の情報が不足していても、日時式として扱われる場合があります。そういった場合に、不足している情報は AppSheet によって補完されます。また、日付型や時刻型を日時型として扱おうとした場合にも、不足している情報が補完されます。

日時式の加減算

日時式と整数値（Number）を加減算する場合、日時式の型によって結果が異なります。ただし整数値から日時式を引くことはできません。

日時型または日付型と整数値を加減算すると、日（day）の情報が加減されます。カレンダーに存在しない日付が発生しないように、適切に月や年の情報も更新されます。

時刻型・期間型と整数値を加減算すると、時（hour）の情報が加減されます。時刻型では時（hour）の値が 0 から 23 の間の整数値になるように、24の繰り上がり・繰り下がりが発生します。

日時式どうしの加減算には以下の3つの制約があります。

1: 日時型・日付型・時刻型の日時式の組み合わせで足し算は不可

2: 日時型・日付型・時刻型の日時式どうしで引き算をすることができる

このとき結果は期間型になります。日付型 - 時刻型 のように異なる型どうしで計算を行ってもエラーにはなりませんが、そのデータが持っていない情報については AppSheet に設定されているデフォルトの値が自動で利用されるので、注意が必要です。

3: 期間型は全ての日時式と加減算を行うことができます。

日時型・日付型と期間型で加減算を行うと日時型の値を返します。

時刻型と期間型の組み合わせだと時刻型、期間型どうしだと期間型の値を返します。

ただし、期間型から日時型・日付型・時刻型を引くことはできません。

「日時式どうしの計算では必ず期間型が登場する」と覚えておきましょう。

重要なテクニックとして、"00:00:00" という時刻型の値を利用して、時刻型と期間型を自在に変換することができます。

"03:04:05" は時刻型ですが、"03:04:05" - "00:00:00" を計算した結果の "003:04:05" は期間型です。"2023/01/02" + "03:04:05"  は日付型と時刻型の足し算なのでエラーになりますが、"2023/01/02" + "003:04:05" は日付型と期間型の足し算なのでエラーにはならず、"2023/01/02 03:04:05" という日時型の値を返します。このように、"00:00:00" を利用した時刻型と期間型の変換を行うことで、擬似的に日付型と時刻型の足し算を行うことができます。

日時関数

日時を扱う関数を紹介します。

DATETIME関数、DATE関数、TIME関数

DATETIME関数は、日時型・日付型・時刻型の when を日時型に変換する関数です。同様にDATE関数は日付型、TIME関数は時刻型に変換します。

時刻型から日時型・日付型への変換や、日付型から日時型・時刻型への変換では不足している情報の補完が行われます。時刻型のデータは日付の情報をもっていないため、日時型や日付型に変換される際には "1899/12/30" を利用します。また、日付型のデータは時間の情報をもっていないため、日時型や時刻型に変換される際には "00:00:00" を利用します。これらの値は AppSheet の日時式のデフォルト値として設定されているため、覚えておくと良いです。

NOW関数、TODAY関数、TIMENOW関数、UTCNOW関数

NOW関数、TODAY関数、TIMENOW関数、UTCNOW関数は、現在の日時（日付・時間）を取得する関数です。

NOW関数は現在の日時を日時型で返します。

TODAY関数は現在の日付を日付型で返します。

TIMENOW関数は現在の時間を時刻型で返します。

NOW関数、TODAY関数、TIMENOW関数が取得する日時（日付・時間）はユーザーの端末のタイムゾーン設定の影響を受けます。タイムゾーンの設定に影響されない日時を取得するにはUTCNOW関数を利用します。

UTCNOW関数は現在の日時をUTC時間（Coordinated Universal Time：協定世界時）で取得し、日時型で返します。日本のタイムゾーンはUTC時間よりも9時間進んでいます。

UTCNOW関数が "2023/01/01 00:00:00" を取得する場合、タイムゾーンが日本に設定された端末上でのNOW関数の結果は "2023/01/01 09:00:00" になります。

YEAR関数、MONTH関数、DAY関数

これらの関数は、日時型・日付型・時刻型の when を入力にとり、年・月・日を整数型で返します。when が日時型・日付型・時刻型の日時式でない場合には 0 を返します。また、when が日付の情報を持っていない時は、AppSheet のデフォルト値である "1899/12/31" が利用されます。

YEAR関数は年 (year) を表す4桁の整数を返します。

MONTH関数は月 (month) を表す 1 から 12 の整数を返します。

DAY関数は日 (day) を表す 1 から 31 の整数を返します。

HOUR関数、MINUTE関数、SECOND関数

これらの関数は、期間型の duration を入力にとり、時・分・秒を整数型で返します。 duration が期間型でない場合には 0 を返します。入力が期間型であることに注意が必要です。日時型や時刻型から時・分・秒を取得したい場合には、(日時型の場合は TIME 関数で時刻型に変換してから) "00:00:00" との引き算をすることで期間型に変換してから関数に入力する必要があります。

HOUR 関数は時 (hour) を表す 0 から 59 の整数を返します。MINUTE 関数は分 (minute) を表す 0 から 59 の整数を返します。SECOND 関数は秒 (second) を表す 0 から 59 の整数を返します。

YEAR 関数などの利用例

TOTALHOURS関数、TOTALMINUTES関数、TOTALSECONDS関数

これらの関数は、期間型の duration が何時間・何分間・何秒間に相当するかを小数型で返します。たとえば "000:15:00" は 15 分間を表す期間型ですが、何時間かで数えると 1 時間の 4 分の 1、つまり 0.25 時間です。期間型をもとに単位を統一することができるため、合計稼働時間の計測などに便利です。HOUR 関数、MINUTE 関数、SECOND 関数とは異なり TOTALHOURS と複数形であることにも注意しましょう。

TOTALHOURS 関数などの利用例

EOWEEK関数、EOMONTH関数、EWOMONTH関数

EOWEEK関数は、日時型または日付型の when を入力にとり、when の週の最終日（土曜日）を日付型で返します。関数名は end of week（週末）の省略形でしょう。

EOMONTH関数は、日時型または日付型の when と 整数型の offset-month を入力にとり、when から offset-month ヶ月後の月の最終日を日付型で返します。関数名は end of month（月末）の省略形でしょう。

EWOMONTH関数は、日時型または日付型の when と 整数型の offset-month を入力にとり、when から offset-month ヶ月後の月の最後の平日を日付型で返します。ここでの平日とは月曜日から金曜日のことであり、祝日は考慮されません。関数名は end weekday of month（月の最後の平日）の省略形でしょう。

WORKDAY関数

WORKDAY関数は、日付型の when と整数型の days を入力にとり、when から days 営業日後の日付を返します。ここでの営業日とは月曜日から金曜日のことで祝日は考慮されません。オプションとして日付型のリスト holidays を入力することで、リストに含まれる日付は営業日から除外します。

WEEKDAY関数、WEEKNUM関数、ISOWEEKNUM関数

WEEKDAY関数は、日時型または日付型の when の曜日を 1 から 7 の整数値に変換して返します。曜日と整数の対応は、1が日曜日で順に割り当てられ、7が土曜日です。

WEEKNUM関数は、日時型または日付型の when がその年の第何週にあたるかを 1 から 53 の整数値で返します。1月1日が含まれる週が第1週で、12月31日が含まれる週が第53週です。AppSheet では週は日曜日に開始するものとして扱われます。

ISOWEEKNUM関数は、WEEKNUM関数同様に、日時型または日付型の when がその年の第何週にあたるかを 1 から 53 の整数値で返します。ただしISOWEEKNUM関数はISO週番号を取得します。ISO週番号とは国際標準化機構（ISO：International Organization for Standardization ）が定めた、日付と時刻の表記に関する規格「ISO 8601」で規定されているカレンダーの週番号のことです。ISO週番号では必ずしも1月1日が第1週になるとは限りません。

まとめ

本記事では AppSheet で取り扱う日時型について解説しました。

初学者の方・アプリ開発をより発展的に使っていきたい方は参考にしてみてください。

その他の AppSheet 関数に関する詳しい記述は、弊社出版中の書籍付録でもご確認いただけますのでぜひ併せてご覧ください。

ノーコードツール Google AppSheet 標準アプリ開発入門

AppSheet に関する実績やサービス詳細、価格表等についてもっと詳しく知りたい場合は、資料もご用意しておりますのでお問い合わせください。