構文
TIME(time_value, [format], [precision])
- time_value (時刻値)—時刻を作成するのに用いる値です。時間、分、秒を表す文字列または数値として入力する必要があります。文字列を使用する場合は、「HH:MM AM」または「HH:MM:SS PM」のように、時間、分、秒をコロンで区切る必要があります。数値を使用する場合は値をコンマで区切る必要があり、また最適な形式と精度の値を適用するには 3 つの時刻区分 (時間、分、秒) を入力する必要があります。
- format (形式)—[任意][オプション] 時刻の表示に 12 時間形式 (0) と 24 時間形式 (1) のどちらを使用するかを指定します。
- precision (精度)—[任意][オプション] 最初に形式を設定する必要があります。返す時刻の間隔を、hh (1)、hh:mm (2)、hh:mm:ss (3) のいずれかで指定します。
使用例
例 1 → TIME("4:30 PM", 1, 3) 構文 → TIME(時刻値, [形式], [精度])
例 2 → TIME(4, 30, 10, 0) 構文 → TIME(時刻値, [形式])
例 3 → TIME("8:30")+5 構文 → TIME("時間:分")+分
利用上の注意
time_value引数には、以下の3つのフォーマットのいずれかを入力する：
- 文字列フォーマット：時間を表す数字やテキストを入力する。
- 例えば、=TIME("午後8時30分", 1)は20時30分を返す。
- オプションの引数を追加すると、=TIME("8:30 PM", 1,3)は20:30:00を返す。
- セル参照：セル参照：セル参照は通常、日付/時刻値（システム・カラムまたはテキスト/数値フィールド）から抽出された時刻値、またはドロップダウンリストを通じてセルに入力された明確な時刻値を含む。
ドロップダウン・リストは、適切な書式を保証するため、フォームからセルに時間値を追加する場合に推奨されます。
- 数値入力： 時、分、秒をカンマ区切りで3つまで入力可能。
- 例えば、=TIME(9, 30,15)は午前9時30分15秒を返す。
- UNPARSEABLEエラーや予期せぬ出力を避けるため、オプション引数を使用する場合は、時間、分、秒の3つの要素すべてを指定しなければならない。
Modified(Date)やCreated(Date)のようなSystem列から時間要素を抽出するには、以下のように最後の8文字を返すように設定したRIGHT()関数を使用する：
- =TIME(RIGHT(Modified@row, 8)).
TIMEは、より大きな数式で利用できる時間オブジェクトを出力します。例えば、午前 9:00 より前に朝の電子メールを送信する場合、式は次のようになります。
=IF(TIME([Time of Day]1) < TIME(9, 0, 0), "モーニングメールを送ろう！")
オプションのformatとprecision引数を省略した場合、TIME関数の出力はtime_valueがどのように表現されるかに依存します。例えば以下のようになります。
=TIME("15") returns 15, whereas =TIME("3 PM") returns 3 PM.
例
計算の実行時には、TIME() と他の値の使用順序が重要になります。以下の表は、TIME と列タイプを使用する順序に基づいた結果の例を示しています。
コピー/ペーストの後に #UNPARSEABLE エラーが発生した場合は、代わりに式を手動で入力してみてください。
テキスト/数値列タイプ
| TIME 式の入力 | 戻り値 | 時刻参照 | コメント |
|---|---|---|---|
| =TIME(10, 0) | 10:00 AM | 10:00 AM | 時刻オブジェクトを作成 |
| =TIME(時刻参照@row, 1) | 11:45 | 11:45 AM | 別のセルを参照する時刻オブジェクトを作成 |
| =TIME(時刻参照@row, 0) + 5 | 8:35 AM | 08:30AM + 5 分 | 時刻オブジェクトに 5 分を追加 - 例 1 |
| =TIME("8:30")+5 | 08:35 | 08:30 + 5 分 | 時刻オブジェクトに 5 分を追加 - 例 2 |
| =TIME("8:30 PM",1) + 5 | 8:35 PM | 20:30 + 5 分 | 時刻オブジェクトに 5 分を追加 - 例 3 |
| =TIME("2:55 PM", 0) | 2:55 PM | 14:55 | 時刻オブジェクトを 12 時間形式で表現 |
| =TIME("2:55 PM", 1) | 14:55 | 02:55 PM | 時刻オブジェクトを 24 時間形式で表現 |
| =TIME(時刻参照@row) - 270 | 3:30 AM | 03:30 | 時刻オブジェクトから 270 分を減算 |
| =TIME(RIGHT(更新日時@row, 8)) | 10:54 AM | 10:54 | 最終更新日時を時刻オブジェクトに変換 |
| =TIME(RIGHT(更新日時@row, 8)) + 4 | 10:59 AM | 10:59 | 最終更新時刻に 4 分追加 |
| =(TIME(時刻参照10) - TIME(Return10)) | 0.1875 | 稼働日に対する割合としての 2 つの時刻の差 | |
| =(TIME(時刻参照10) - TIME(Return10)) * 24 | 4.500 | 2 つの時刻の差を時間単位の表示に変換 (稼働日が 24 時間の場合のみ機能) | |
| =(TIME(時刻参照10) - TIME(Return10)) * 1440 | 270 | 2 つの時刻の差を分単位の表示に変換 (稼働日が 24 時間の場合のみ機能) |
日付列タイプ
| TIME 式の入力 | 戻り値 | コメント |
|---|---|---|
| =ROUNDDOWN((TIME(時刻参照10) - TIME(Return10)) * 24) + "時間と " + VALUE(RIGHT((TIME(時刻参照10) - TIME(Return10)) * 24, FIND(".", (TIME(時刻参照10) - TIME(Return10)) * 24))) * 60 + " 分" | 4 時間と 30 分 | 時刻の差を時間と分の文字列に変換 (稼働日が 24 時間の場合のみ機能) |
| =DATEONLY(更新日時9) - DATEONLY(更新日時10) + " 日、" + " " + ROUNDDOWN((TIME(RIGHT(更新日時9, 8)) - TIME(RIGHT(更新日時10, 8))) * 24) + " 時間 " + (((TIME(RIGHT(更新日時9, 8)) - TIME(RIGHT(更新日時10, 8))) * 24) - ROUNDDOWN((TIME(RIGHT(更新日時9, 8)) - TIME(RIGHT(更新日時10, 8))) * 24)) * 60 + " 分" | 0 日、1 時間 31 分
| 時刻の差を日、時間、分の文字列に変換 (稼働日が 24 時間の場合のみ機能) |
| ="期日: " + DATEONLY(作成日時@row) + " @" + (TIME(RIGHT(作成日時@row, 8)) + 120) | 期日: 08/28/23 @11:54 AM | 作成日時を使用し、タスクの SLA を分単位で仮定して期日の日付と時刻を生成 |
コンタクトリストのカラムタイプ
| TIME 式の入力 | 戻り値 | 時刻参照 | 割り当て先 | コメント |
|---|---|---|---|---|
| =TIME(1, 0) + " - " + 割り当て先 6 | 1:00 AM - ジョン・ドー | 1:00 | ジョン・ドー | 時刻オブジェクトに情報の文字列を追加 |
さらにサポートが必要な場合
フォーミュラ・ハンドブック 数式ハンドブックテンプレートを使用して、より多くのサポートやリソースを検索したり、100 種類以上の数式を表示したり、リアルタイムで作業を練習できる各関数の用語集を確認したり、よく使用される数式や高度な数式の例を検索したりできます。
Smartsheet のオンライン コミュニティでは、他のお客様がこの関数をどのように使用しているか、または特定の使用例について質問することができます。