SenseTalkの日付と時間の値
SenseTalkは、日付と時間を操作するためのコマンドと関数を含ん でいます。一つの日付または時間から別の日付または時間をマイナス( - )演算子を使用して減算し、その差を秒で得ることができます。時間間隔を日付または時間に追加することで、新しい日付/時間値を得ることも可能です(時間間隔の追加と減算を参照してください)。
日付、時間、および時間間隔
SenseTalkでは、「日付」と「時間」の基本的な区別はありません - どちらも時間の流れの中の精密な瞬間、またはタイムライン上のポイントとして扱われます。その起源(ゼロ値)は2001年1月1日の始まりの真夜中に、調整世界時でした。その瞬間以前の任意の日付または時間は内部的には負の値として扱われ、後の時間は起源以降の秒数を示す正の値として扱われます。
SenseTalkは、「4/22/67」または「1967-04-22 18:00」のような多様な形式で表現された日付と時間を認識することができます。詳細については、the timeInputFormat
グローバルプロパティを参照してください。Natural
フォーマットでは、さらに多くのバリエーションを許容し、「May 15, 2004 10:57 PM」、または"yesterday"、"today"、や"next Tuesday in the afternoon." などを許容します。 today
とnow
(引用符で囲まれていない)の単語は、現在の日付または現在の日付と時間を指示するために使用できます(それらが変数として使用され、他の値が割り当てられていない場合)。このフォーマットについての詳細情報については、Natural
Formatを参照してください。
日付値が一日の時間を指定せずに提供されると、その日の正午を意味するとみなされます。日付なしで時間が指定されると、現在の日付(今日)の指定時間を意味するとみなされます。すべての日付と時間は、スクリプトが実行されているマシン上で現在設定されているローカルタイムゾーンであると想定されます。
_time interval_または_duration_は、時間の長さです。時間間隔を扱うとき、SenseTalkは特定の単位が与えられない場合、秒単位で測定された持続時間を想定しますが、週、日、時間、ミリ秒など、他の多くの単位も使用できます(Values内のTime Intervalsを参照してください)。
秒で正確に測定できる持続時間に加えて、SenseTalkは、月、calendarQuarters、calendarYearsなどを含む月を基準に測定された_calendar durations_ もサポートしています。使用可能なcalendarDuration単位の全リストを確認するには、次のコマンドを使用します:
put (each item of the unitNames whose unitType is calendarDuration) sorted
詳細については、Values内のCalendar Durations in Valuesを参照してください。
時間間隔とカレンダーの持続時間の両方を、過去または未来の時間値を生成するためのago and hence operatorsと一緒に使用できます。
日付と時間に実質的な違いはないため、この文書では、日付または時間を「日付/時間値」として参照することがあります。
関連するグローバルプロパティとローカルプロ パティ
SenseTalkには、スクリプト内の日付と時間の値の動作に影響を与えるために使用できるいくつかのグローバルまたはローカルプロパティが含まれています。これらのプロパティは以下の概念の説明で言及されています。各プロパティの完全な定義は、Local and Global Properties for Working with Values で見つけることができます。具体的なプロパティは以下のとおりです:
The ClockFormat
The TimeFormat
The TimeInputFormat
The CenturyCutoff
The LastDayOfMonthCalculation
日付/時間の算術
時間間隔の追加と減算
任意の日付(または時間)から始めて、時間間隔を単純に追加または減算することにより、異なる日付/時間を取得することができます。
例:
put today + 2 weeks into dueDate
例:
subtract 3 hours 14 minutes 22 seconds from timer
日付または時間の差の計算
一つの日付または時間の値を別のものから引くことにより、日付間の日数や何かのプロセスにかかる経過時間を簡単に計算することができます。差は常に秒単位の時間間隔として表現されますが、それを(1 day
のような時間間隔の表現を使用して)その単位の秒数で割ることにより、異なる単位(例えば日)に変換することができます。
例:
put (expirationDate - "today") / 1 day into daysRemaining -- results in a pure number
put (expirationDate - "today") as days into daysRemaining -- results in a number with units of days
例:
put the time into startTime -- Start timing here
run somethingTimeConsuming -- Whatever you want to time
put the time - startTime into secondsElapsed
日付または時間の比較
SenseTalkの比較演算子(is
、=
、comes before
、<
など)は、通常、比較される二つの値をテキストとして扱います。ただし、それらがどちらも数字であるか、あるいはそれらがどちらも日付または時間の値であると「知っている」場合を除きます。比較は通常、値をテキストとして扱いますので、以下のような場合には望ましい結果を得られません:
if the date is between "Sep 21" and "Dec 21" then put "Happy Autumn"
SenseTalkに日付または時間の比較を行わせるためには、date()またはtime()関数を使用してテキストを内部の日付/時間の表現に変換します。これがうまくいきます(年が指定されていない場合、現在の年が想定されるので、この例は任意の年で動作します):
if the date is between date ("Sep 21") and date ("Dec 21") then
put "Happy Autumn!"
end if
日付と時間を扱うためのコマンドと関数
以下に、SenseTalkで日付と時間の値を操作するために使用できる特定のコマンドと関数を示します。
Date
, asDate
関数
動作: 現在の日付、または与えられた式の日付値を返します。 long date
関数は、現在の曜日と月のフルネームを含む日付の詳細なバージョンを返します。Abbreviated date
とshort date
のバリエーションは、他の形式で日付を提供します。 date
関数が返す値は、テキストに変換されると、自動的にフォーマットされた日付を表示します(例で示されています)。その値は、また、日付/時間の計算に使用するため、関数が呼び出された時の正確な日付と時間を表す数値として扱うこともできます。 dateExpr
が与えられた場合、その日の正午を表す値を返します(dateExpr
に1日の時間が含まれている場合、それは無視されます)。
asDate
関数もdateExpr
の指定された値を日付に変換しますが、標準の日付形式を割り当てる代わりに、asDate
関数はdateExpr
自体の形式から形式を導き出します。asDate関数はas {a} date
演算子を使用しても呼び出すことができます。
構文:
the { [ long | short | abbr{ev{iated}} ] } date {of dateExpr}
date( {dateExpr} )
asDate( dateExpr )
例:
put the date --> "10/07/95"
put the short date --> "10/7/95"
put the abbrev date --> "Sat, Oct 7, 1995"
put the long date --> "Saturday, October 7, 1995"
例:
put date("May 14, 1942") --> "05/14/42"
例:
put asDate("May 14, 1942") --> "May 14, 1942"
関連:
TimeZoneOffset
, UTCOffset
, SecondsFromGMT
関数
動作: 現地時間と協定世界時(UTC)との間の秒単位の差を返します(同義のsecondsFromGMT
は歴史的な用語であるグリニッジ標準時(GMT)を参照します)。日付が1つ指定されて呼び出された場合、それは指定された日 付でのUTCからの現地の差を返します(その日に夏時間が有効かどうかによって異なる可能性があります)。
put UTCOffset("June 4, 2001") / 1hour -- -6を返す
タイムゾーンを指定する際には、公式のID名(例:"America/Los_Angeles")、タイムゾーンの略称("PDT")、または名前の一部をスペースや特殊文字を無視して使うことができます(例:"los angeles")。
構文:
the [ TimeZoneOffset | UTCOffset | SecondsFromGMT ] {of aDateOrTimeZone } [ TimeZoneOffset | UTCOffset | SecondsFromGMT ]( {aDateOrTimeZone} ) [ TimeZoneOffset | UTCOffset | SecondsFromGMT ]( aDate , aTimeZone ) [ TimeZoneOffset | UTCOffset | SecondsFromGMT ]( aTimeZone , aDate )
例:
put the TimeZoneOffset --> -7 hours (example shown in Mountain Standard Time)
put the SecondsFromGMT --> -25200 (the same value as a plain number of seconds)
put the TimeZoneOffset of "July 1" --> -6 hours (July is in Mountain Daylight Time)
例:
put TimeZoneOffset("March 4, 2001", "Denver") --> -7 hours
put UTCOffset("Paris", "2023-07-10") --> 2 hours
例:
Seconds
関数
動作: 2001年1月1日以来の現在の秒数を返します。long seconds
関数は、現在の秒の部分を含む、秒数のより正確なバージョンを返します。abbreviated seconds
とshort seconds
のバリエーションも利用可能で、それぞれマイクロ秒(6小数位)とミリ秒(3小数位)までの値を提供します。dateTimeValue
が指定された場合、返される数値は、2001年1月1日の始まりから指定された時間までの秒数となります(指定された時間が2001年より前の場合、数値は負となります)。
構文:
the { [ long | short | abbr{ev{iated}} ] } seconds
the seconds {of dateTimeValue}
seconds( {dateTimeValue} )
例:
put the long seconds -- 62899676.90865231
例:
put the long seconds --> 62899676.90865231
put abbreviated seconds --> 62899676.908652
put the short seconds --> 62899676.908
関連:
Ticks
関数
動作: SenseTalkエンジンが起動してからのtick数(1/60秒)を返します。
構文:
the ticks
ticks()
例:
if the ticks is greater than 36000 then
put "SenseTalk was started more than 10 minutes ago."
end if
関連:
Time
, AsTime
関数
動作: 現在の時刻、または指定された表現の時間値を返します。 long time
関数は、秒を含む時間の長いバージョンを返します。 Abbreviated time
と short time
のバリエーションは、他の形式で時間を提供します。
asTime
関数も_timeExpr_で指定された値を時間に変換しますが、標準の時間形式を割り当てる代わりに、asTime
関数は_timeExpr_自体の形式から形式を導き出します。asTime関数はas {a} time
オペレーターを使用して呼び出すこともできます。
構文:
the { [ long | short | abbr{ev{iated}} ] } time {of timeExpr}
time( {timeExpr} )
asTime( {timeExpr} )
例:
put the time --> 02:38 PM
put the short time --> 02:38
put the abbrev time --> 02:38:32
put the long time --> 02:38:32 PM
例:
put time("7:35:42")-- "07:35 AM"を表示
例:
put asTime("7:35:42") -- "07:35:42"を表示
time
関数によって返される値は、テキストに変換すると自動的にフォーマットされた時間を表示します。その値は、関数が呼び出された正確な日時(またはそのパラメーターによって表される正確な日時)を表す数値としても扱うことができます。これは、日時の計算や比較で使用されます。
the clockFormat
グローバルプロパティが"24 hour"に設定されている場合、すべての時間関数が使用するフォーマットには"AM"や"PM"が含まれず、代わりに00から23の間の時間を表示します。
_timeExpr_が指定された場合、その値は評価され、内部の時間表現として返されます。
_timeExpr_が指定されると、その値が評価されて内部時間表現として返されます。これは他の変換関数と一貫性を保つため、asTime
という名前で呼び出すこともできます。
関連:
日付または時間のコンポーネント
以下の関数は、指定された日付または時間の個々のコンポーネントを提供します。また、パラメータなしで呼び出された場合、各関数は現在の日付または時間の特定のコンポーネントを返します。例えば:
the hour
は現在の時間を返しますthe hour of "8.45 AM"
は指定された時間の時間要素を返します。この場合、8
です。
Year
関数
動作: 指定された日付の年数、または現在の年を返します。
構文:
the year {of dateTimeValue}
year( {dateTimeValue} )
例:
put the year into currentYear
例:
put the dayOfYear of "4 July 1776" -- "186" (the 186th day of the year)
関連:
Month
関数
動作: 指定された日付の月の数(1から12まで)、または現在の月を返します。
構文:
the month {of dateTimeValue}
month( {dateTimeValue} )
例:
put the month into monthNum
例:
put month("4 July 1776") -- "7"
関連:
MonthName
関数
動作: 指定された日付の月名、または現在の月を返します。
構文:
the monthName {of dateTimeValue}
monthName( {dateTimeValue} )
例:
put monthName() into monthName
例:
put the monthName of "27 April 2022" --> "April"
関連: