エクスプレッション

整数

42

-17

数値

3.14159

-.33

ブール値

TRUE

FALSE

テキスト

"Hello"

"First"

\n

改行

\r

キャリッジ リターン

\f

フォーム フィード

\"

二重引用符

\t

タブ

\b

バックスペース

\\

バックスラッシュ文字自体

\uXXXX

コード化された 16 進数の Unicode 文字。たとえば 「\u002A」 は、「*」の別の表記です。

abs(Integer)

整数

abs(Number)

数値

ceil(Number)

整数

ceil(2.4) は 3 を返します。

computeMD5(binary: Binary)

テキスト

バイナリ入力の MD5 チェックサムを計算します。

floor(Number)

整数

floor(8.7) は 8 を返します。

round(Number)

整数

算術規則に基づいて、指定された数値よりも大きいまたは小さい最小の整数を返します。

round(1.6) は 2 を返します。

trunc(Number)

整数

trunc(4.8732) は 4 を返します。

max(Integer, Integer)

整数

max(Number, Number)

数値

min(Integer, Integer)

整数

min(Number, Number)

数値

random()

数値

random()

random(Integer, Integer)

整数

Random(5, 96)

ampersandDecode(Text)

テキスト

ampersandEncode(Text)

テキスト

base64Decode(Text)

バイナリ

binary(Text, Text)

バイナリ

テキスト値をバイナリに変換します。

boolean(Text)

ブール値

テキストは「true」または「false」のいずれかになります。

boolean("true") は、ブール型の「true」を返します。

capitalize(Text)

テキスト

各単語の最初の文字が大文字で、残りの文字が小文字であるテキストを返します。

capitalize("hello world") は Hello World を返します。

contains(Text, Text)

ブール値

テキストに指定したテキストが含まれていることを確認します。

endsWith(Text, Text)

ブール値

indexOf(Text, Text)

整数

integer(Text)

整数

length(Text)

整数

記号の数を計算して、テキストの長さを返します。

matches(text: Text, regex: Text)*

ブール値

テキストが正規表現に一致するかどうかをチェックします。

matches("My phone number is 123-45-678", "(.*)( \\d{3}-\\d{2}-\\d{3})") は true を返します。

number(Text)

数値

password(Text)

パスワード

テキストをパスワードに変換します。これは、ロボットの開発中にアプリケーションにログインする際にパスワードが必要な場合に役立ちます。セキュリティ上の理由から、この関数を本番環境で使用しないでください。

removeNonPrintable(Text)

テキスト

印刷不可文字を含まないテキストを返します。

removeNonPrintable("Text with non-printable characters")

replaceAll(text: Text, regex: Text, replacement: Text)*

正規表現に一致するすべてのサブテキストを、指定された置換文字に置き換えます。

正規表現は、$ を使用した複数の一致検索および参照をサポートしています。

円記号をエスケープする必要があることに注意してください。

startsWith(Text, Text)

ブール値

substring(Text, Integer)

テキスト

substring(Text, Integer, Integer)

テキスト

toJSON(Text)

テキスト

toLowerCase(Text)

テキスト

toUpperCase(Text)

テキスト

trim(Text)

テキスト

テキストの最初と最後の余分なスペースを削除します。

unquote(text: Text)

テキスト

テキストから引用符を除去します。

dateTime()

DateTime

現在の日付 (年、月、日)、時刻 (時、分、秒)、オフセット、および zoneID を返します。

dateTime(date: Date, time: Time)

DateTime

指定の日付と時刻を返します。

例

dateTime(date(2022, 1, 10), time(12, 0, 5)) は、日付 (年 = 2022、月 = 1、日 = 10)、時刻 (時 = 12、分 = 0、秒 = 5、ナノ秒 = 0)、zoneID = "[DateTime のタイム ゾーン]" を返します。

dateTime(date: Date, time: Time, zone: Text)

DateTime

指定した日付、時刻、およびタイム ゾーン ID またはオフセットを返します。

例

dateTime(date(2010,11,08), time(12,44,00), zoneId(Dublin))

dateTime(text: Text, pattern: Text)

DateTime

コンピュータのデフォルトのロケールを使用して、Text 値を DateTime 値に変換します。

例

dateTime("2022-01-02 12:30", "yyyy-MM-dd HH:mm")

dateTime(text: Text, pattern: Text, locale: Text)

DateTime

パターンとロケールを使用して、テキストから DateTime 値を作成します。

例

dateTime("January 1, 2022 12:30", "MMMM d, yyyy HH:mm ", "en-US").

dateTime(text: Text, pattern: Text, defaultDate: Date)

DateTime

パターンと、テキストに日付が含まれていない場合に使用するデフォルトの日付を使用して、Text 値を DateTime 値に変換します。

例

dateTime("12:30", "HH:mm", date())

ここで、日付は現在の日付です。

dateTime(text: Text, pattern: Text, dafaultDate: Date, locale: Text)

DateTime

パターン、デフォルトの日付、およびロケールを使用して、テキストから DateTime 値を作成します。パターンによってテキストと日付が一致する場合はロケールが使用され、デフォルトの日付は使用されません。テキストに日付が含まれていない場合は、デフォルトの日付が使用されます。

例

offset(dateTime: DateTime)

テキスト

DateTime 値のオフセットを返します。

例

offset(dateTime()) は、使用しているコンピュータにおける現在の日付のオフセットを +01:00 のような形で返します。

zoneId(dateTime: DateTime)

テキスト

DateTime 値のタイム ゾーンを返します。

例

zoneId(dateTime()) は、現在の日付の zoneID の値を Europe/Paris のような形で返します。

withYears(dateTime: DateTime, years: Integer)

DateTime

年を変更した日付と時刻を新たに返します。

例

dateTime(date(2021, 7, 20), time(12, 13, 14)).withYears(2022) は、年が 2022 である DateTime 値を返します。

withMonth(dateTime: DateTime, months: Integer)

DateTime

月を変更した日付と時刻を新たに返します。例については、「withYears」を参照してください。

withDay(dateTime: DateTime, days: Integer)

DateTime

日を変更した日付と時刻を新たに返します。例については、「withYears」を参照してください。

withHour(dateTime: DateTime, hours: Integer)

DateTime

時間を変更した日付と時刻を新たに返します。例については、「withYears」を参照してください。

withMinute(dateTime: DateTime, minutes: Integer)

DateTime

分を変更した日付と時刻を新たに返します。例については、「withYears」を参照してください。

withSecond(dateTime: DateTime, seconds: Integer)

DateTime

秒を変更した日付と時刻を新たに返します。例については、「withYears」を参照してください。

withNano(dateTime: DateTime, nanos: Integer)

DateTime

ナノ秒を変更した日付と時刻を新たに返します。例については、「withYears」を参照してください。

withOffset(dateTime: DateTime, offset: Text)

DateTime

指定したオフセットの日付と時刻を新たに返します。オフセットを変更すると、オフセットとゾーン ID が互いに矛盾しないように、ゾーン ID が変更される場合があります。

例 (オフセットが +1 の場合)

withOffset(dateTime(), "+3") は、オフセットが +3 の時刻を返します。これは、時刻が現在の時刻よりも 2 時間進んでいることを意味します。また、ゾーン ID は UTC +03:00 (ヨーロッパ/モスクワ) に変更されます。

withZoneId(dateTime: DateTime, zoneID: Text)

DateTime

指定したタイム ゾーンの日付と時刻を新たに返します。ゾーン ID を変更すると、ゾーン ID とオフセットが互いに矛盾しないように、オフセットが変更される場合があります。

例

withZoneId(dateTime(), "Europe/Moscow") は、指定されたゾーン ID における現在の時刻を返します。

plusYears(dateTime: DateTime, amount: Integer)

DateTime

指定した年数を加えた日付と時刻を新たに返します。

例

dateTime(date(2021, 7, 20), time(12, 13, 14)).plusYears(1) は、ロボットが実行されるタイムゾーンにおける、日時 2022-07-22 12:13:14.0 の DateTime 値を返します。

plusMonths(dateTime: DateTime, amount: Integer)

DateTime

指定した月数を加えた日付と時刻を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusWeeks(dateTime: DateTime, amount: Integer)

DateTime

指定した週数を加えた日付と時刻を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusDays(dateTime: DateTime, amount: Integer)

DateTime

指定した日数を加えた日付と時刻を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。

plusDays(70) を使用した次の例では、3 月は 31 日、4 月は 30 日あるという前提に基づき、まず 3 月 4 日に 27 日を追加し、さらに残りの 43 日を追加して 5 月 13 日としています。

例

dateTime(date(2022, 3, 4), time(12, 13, 14)).plusDays(70) は、日付 (年 = 2022、月 = 5、日 = 13)、時刻 (時 = 12、分 = 13、秒 = 14、ナノ秒 = 0)、zoneID = "[DateTime のタイム ゾーン]" を返します。

plusHours(dateTime: DateTime, amount: Integer)

DateTime

指定した時間数を加えた日付と時刻を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusMinutes(dateTime: DateTime, amount: Integer)

DateTime

指定した分数を加えた日付と時刻を新たに返します。

例

dateTime(date(2022, 7, 20), time(12, 13, 14)).plusMinutes(7) は、日付 (年 = 2022、月 = 7、日 = 20)、時刻 (時間 = 12、分 = 20、秒 = 14、ナノ秒 = 0)、zoneID = "[DateTime のタイム ゾーン]" を返します

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。

plusSeconds(dateTime: DateTime, amount: Integer)

DateTime

指定した秒数を加えた日付と時刻を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusNanos(dateTime: DateTime, amount: Integer)

DateTime

指定したナノ秒数を加えた日付と時刻を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

minusYears(dateTime: DateTime, amount: Integer)

DateTime

指定した年数を差し引いた日付と時刻を新たに返します。

例

dateTime(date(2022, 7, 20), time(12, 13, 14)).minusYears(10) は、ロボットが実行されるタイムゾーンにおける、日時 2012-07-22 12:13:14.0 の DateTime 値を返します。

minusMonths(dateTime: DateTime, amount: Integer)

DateTime

指定した月数を差し引いた日付と時刻を新たに返します。

例

minusWeeks(dateTime: DateTime, amount: Integer)

DateTime

指定した週数を差し引いた日付と時刻を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、「minusMonths」を参照してください。

minusDays(dateTime: DateTime, amount: Integer)

DateTime

指定した日数を差し引いた日付と時刻を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。minusDays(20) を使用した次の例では、3 月は 31 日、2 月は 29 日あるという前提に基づき、まず 3 月 14 日から 14 日を差し引き、さらに残りの 6 日を差し引いて 2 月 23 日としています。

例

dateTime(date(2020, 3, 14),time(12, 13, 14)).minusDays(20) は、日付 (年 = 2020、月 = 2、日 = 23)、時刻 (時間 = 12、分 = 13、秒 = 14、ナノ秒 = 0)、zoneID = "[DateTime のタイム ゾーン]" を返します。

minusHours(dateTime: DateTime, amount: Integer)

DateTime

指定した時間数を差し引いた日付と時刻を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"minusDays" を参照してください。

minusMinutes(dateTime: DateTime, amount: Integer)

DateTime

指定した分数を差し引いた日付と時刻を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"minusDays" を参照してください。

minusSeconds(dateTime: DateTime, amount: Integer)

DateTime

指定した秒数を差し引いた日付と時刻を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"minusDays" を参照してください。

minusNanos(dateTime: DateTime, amount: Integer)

DateTime

指定したナノ秒数を差し引いた日付と時刻を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"minusDays" を参照してください。

yearsUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの年数を計算します。

例

dateTime(date(2022, 1, 20), time(12, 13, 14)).yearsUntil(dateTime(date(3785, 11, 20), time(12, 13, 14))) は 1763 を返します。

monthsUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの月数を計算します。

例

dateTime(date(2022, 1, 20), time(12, 13, 14)).monthsUntil(dateTime(date(2022, 11, 20), time(12, 13, 14))) は 10 を返します。

daysUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの日数を計算します。例については、「monthsUntil」を参照してください。

hoursUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの時間数を計算します。例については、「monthsUntil」を参照してください。

minutesUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの分数を返します。例については、「monthsUntil」を参照してください。

secondsUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの秒数を返します。例については、「monthsUntil」を参照してください。

millisUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までのミリ秒数を返します。例については、「monthsUntil」を参照してください。

nanosUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までのナノ秒数を返します。例については、「monthsUntil」を参照してください。

dayOfYear(dateTime: DateTime)

整数

年の日にちを返します。

例

dateTime(date(2022, 3, 1), time(12, 13, 14)).dayOfYear() は日 = 60 を返します

weeksUntil(from: DateTime, to: DateTime)

整数

最初の DateTime 引数から 2 番目の DateTime 引数までの週数を返します。

例

dateTime(date(2022, 1, 20), time(12, 13, 14)).weeksUntil(dateTime(date(2025, 11, 20), time(12, 13, 14))) は 200 を返します。

text(dateTime: DateTime)

テキスト

DateTime 値をテキスト表現に変換します。

例

text(dateTime()) は、たとえば 2022-02-10T13:46:56.907958+01:00 [ヨーロッパ/パリ] のような形式で現在の日付と時刻を返します。

text(dateTime: DateTime, pattern: Text)

テキスト

DateTime 値を、指定したパターンとロケールに一致するテキスト表現に変換します。パターンは、次のようなさまざまな方法で指定できます。

• "d/M/yyyy HH:mm"

• "d-M-yyyy HH:mm:ss"

例 (DateTime が 2022-12-20T00:30:00+03:00 の場合)

text("d/M/yyyy HH:mm") は 20/12/2022 00:30 を返します。

text(dateTime: DateTime, pattern: Text, locale: Text)

テキスト

指定したパターンとロケールに一致する、DateTime の日付と時刻のテキスト表現を返します。

• パターンは、次のようなさまざまな方法で指定できます。

  • "d/M/yyyy HH:mm"

  • "d-M-yyyy HH:mm:ss"

  • "EEEE MMM d yy HH:mm" (EEEE は完全な曜日を、MMM は 3 文字に省略した月の名前を返します。その他も同様です)

• ロケールは、en-US、fr-FR、ja-JP、ru-RU のように指定します。

例 (現在の日付が 20.12.2021 00:30:00) である場合

text("EEEE MMM d yy HH:mm", "en-US") は Monday Dec 20 21 00:30 を返します。

text("EEE MMMM d yyyy HH:mm", "en-US") は Mon December 20 2021 00:30 を返します。

text("yyyy'年'MM'月'd'日' HH:mm:ss","ja-JP") は 2021年12月20日 00:30:00 を返します。

fromExcelDate(excelDate: Number)

DateTime

DateTime 値を数値として表現された Excel の日付に変換します。

例 (ExcelDate 値が 44969 の場合)

ExcelDate.fromExcelDate() は、year=2023、month=2、day=12 を返します。

toExcelDate(dateTime: DateTime)

Number

DateTime 値を数値として表現された Excel の日付に変換します。

例 (現在の日付が 08.02.2022 18:45:00 である場合)

dateTime().toExcelDate() は 44600.76050844907149439677596092224 を返します。

date()

日付

現在の日付を返します。

date(year: Integer, month: Integer, day: Integer)

日付

指定した年、月、および日の日付を返します。

date(DateTime)

日付

以前に DateTime が指定されていた場合に、DateTime の日付値を返します。

date(text: Text, pattern: Text)

日付

パターンを使用して、Text 値を Date 値に変換します。

例

date("2022-01-02", "yyyy-MM-dd")

date(text: Text, pattern: Text, locale: Text)

日付

パターンとロケールを使用して、Text 値を Date 値に変換します。

例

date("January 1, 2022", "MMMM d, yyyy", "en-US")

year(date: Date)

整数

現在の日付の年を返します。

month(date: Date)

整数

現在の日付の月 (1 ～ 12) を返します。

day(date: Date)

整数

現在の日付の日 (1 ～ 31) を返します。

withYear(date: Date, years: Integer)

日付

年を変更した日付を新たに返します。

例

date(2022, 3, 4).withYear(2037) は、year = 2037、month = 3、day = 4 を返します。

withMonth(date: Date, months: Integer)

日付

月を変更した日付を新たに返します。 date(2022, 3, 4).withMonth(5) は、year = 2022、month = 8、day = 4 を返します。

withDay(date: Date, days: Integer)

日付

日を変更した日付を新たに返します。

例

date(2022, 3, 4).withDay(10) は、year = 2022、month = 3、day = 10 を返します。

plusYears(date: Date, amount: Integer)

日付

指定した年数を加えた日付を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusMonths(date: Date, amount: Integer)

日付

指定した月数を加えた日付を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusWeeks(date: Date, amount: Integer)

日付

指定した週数を加えた日付を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"plusDays" を参照してください。

plusDays(date: Date, amount: Integer)

日付

指定した日数を加えた日付を新たに返します。

どの「plus」関数でも、暦に基づく繰り越し計算が使用されます。plusDays(70) を使用した次の例では、3 月は 31 日、4 月は 30 日あるという前提に基づき、まず 3 月 4 日に 27 日を追加し、さらに残りの 43 日を追加して 5 月 13 日としています。

例

date(2022, 3, 4).plusDays(70) は、year = 2022、month = 5、day = 13 を返します。

minusYears(date: Date, amount: Integer)

日付

指定した年数を差し引いた日付を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。

date(2022, 3, 14).minusYears(20) は、year = 2002、month = 3、day = 14 を返します。

minusMonths(date: Date, amount: Integer)

日付

指定した月数を差し引いた日付を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"minusDays" を参照してください。

minusWeeks(date: Date, amount: Integer)

日付

指定した週数を差し引いた日付を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。例については、"minusDays" を参照してください。

minusDays(date: Date, amount: Integer)

日付

指定した日数を差し引いた日付を新たに返します。

どの「minus」関数でも、暦に基づく繰り越し計算が使用されます。minusDays(20) を使用した次の例では、3 月は 31 日、2 月は 29 日あるという前提に基づき、まず 3 月 14 日から 14 日を差し引き、さらに残りの 6 日を差し引いて 2 月 23 日としています。

例

date(2022, 3, 14).minusDays(20) は、年 = 2022、月 = 2、日 = 23 を返します。

yearsUntil(from: Date, to: Date)

整数

最初の Date 引数から 2 番目 の Date 引数までの年数を返します。

例 (現在の年が 2022 年である場合)

date().yearsUntil(date(2023, 11, 12)) は 1 を返します。

monthsUntil(from: Date, to: Date)

整数

最初の Date 引数から 2 番目 の Date 引数までの月数を返します。例については、「yearsUntil」を参照してください。

daysUntil(from: Date, to: Date)

整数

最初の Date 引数から 2 番目 の Date 引数までの日数を返します。例については、「yearsUntil」を参照してください。

weeksUntil(from: Date, to: Date)

整数

最初の Date 引数から 2 番目 の Date 引数までの週数を返します。例については、「yearsUntil」を参照してください。

isLeapYear(date: Date)

ブール値

年がうるう年の場合は「true」を返し、そうでない場合は「false」を返します。

例

date(2020, 3, 4).isLeapYear は、2020 年がうるう年であったため、true を返します。

text(date: Date)

テキスト

Date 値をテキスト表現に変換します。

例

text(date(2000, 12, 25)) は 2000-12-25 を返します。

text(date: Date, pattern: Text)

テキスト

Date 値を、指定したパターンに一致するテキスト表現に変換します。

例

text(date(2000, 12, 25), "M/YY/d") は 12/00/25 を返します。

text(date: Date, pattern: Text, locale: Text)

テキスト

Date 値を、指定したパターンとロケールに一致するテキスト表現に変換します。

例

text(date(2023, 12, 12), "MMMM d, yyyy", "de-DE") は Dezember 12, 2023. を返します。

time()

時刻

現在の時刻を返します。

time(hours: Integer, minutes: Integer, seconds: Integer)

時刻

指定した時、分、および秒の時刻を返します。

time(hours: Integer, minutes: Integer, seconds: Integer, nanos: Integer)

時刻

指定した時、分、秒、およびナノ秒の時刻を返します。

time(dateTime: DateTime)

時刻

以前に DateTime が指定されていた場合に、DateTime の時刻値を返します。

time(text: Text, pattern: Text, locale: Text)

時刻

指定したパターンとロケールを使用して、Text 値をTime 値に変換します。

例

time("January 1, 2022 12:30", "MMMM d, yyyy hh:mm a", "en-US")

hour(time: Time)

整数

現在の時刻の時間を返します。

minute(time: Time)

整数

現在の時刻の分を返します。

second(time: Time)

整数

現在の時刻の秒を返します。

nanosecond(time: Time)

整数

現在の時刻のナノ秒を返します。

withHour(time: Time, hours: Integer)

時刻

時間を変更した時刻を新たに返します。

例

time(14, 50, 45).withHour(2) は、時 = 2、分 = 50、秒 = 45、ナノ秒 = 0 を返します。

withMinute(time: Time, minutes: Integer)

時刻

分を変更した時刻を新たに返します。例については、「withHour」を参照してください。

withSecond(time: Time, seconds: Integer)

時刻

秒を変更した時刻を新たに返します。例については、「withHour」を参照してください。

withNano(time: Time, nanos: Integer)

時刻

ナノ秒を変更した時刻を新たに返します。例については、「withHour」を参照してください。

plusHours(time: Time, amount: Integer)

時刻

指定した時間数を加えた時刻を新たに返します。

例

time(14, 50, 45).plusHours(2) は、時 = 16、分 = 50、秒 = 45、ナノ秒 = 0 を返します。

plusMinutes(time: Time, amount: Integer)

時刻

指定した分数を加えた時刻を新たに返します。例については、「plusHours」を参照してください。

plusSeconds(time: Time, amount: Integer)

時刻

指定した秒数を加えた時刻を新たに返します。例については、「plusHours」を参照してください。

plusNanos(time: Time, amount: Integer)

時刻

指定したナノ秒数を加えた時刻を新たに返します。例については、「plusHours」を参照してください。

minusHours(time: Time, amount: Integer)

時刻

指定した時間数を差し引いた時刻を新たに返します。

例

time(14, 50, 45).minusHours(2) は、時 = 12、分 = 50、秒 = 45、ナノ秒 = 0 を返します。

minusMinutes(time: Time, amount: Integer)

時刻

指定した分数を差し引いた時刻を新たに返します。例については、「minusHours」を参照してください。

minusSeconds(time: Time, amount: Integer)

時刻

指定した秒数を差し引いた時刻を新たに返します。例については、「minusHours」を参照してください。

minusNanos(time: Time, amount: Integer)

時刻

指定したナノ秒数を差し引いた時刻を新たに返します。例については、「minusHours」を参照してください。

hoursUntil(from: Time, to: Time)

整数

最初の Time 引数から 2 番目の Time 引数までの時間数を返します。

例

time(9, 41, 35).hoursUntil(time(15, 34, 12)) は 5 を返します。

minutesUntil(from: Time, to: Time)

整数

最初の Time 引数から 2 番目の Time 引数までの分数を返します。例については、「hoursUntil」を参照してください。

secondsUntil(from: Time, to: Time)

整数

最初の Time 引数から 2 番目の Time 引数までの秒数を返します。例については、「hoursUntil」を参照してください。

millisUntil(from: Time, to: Time)

整数

最初の Time 引数から 2 番目の Time 引数までのミリ秒数を返します。例については、「hoursUntil」を参照してください。

nanosUntil(from: Time, to: Time)

整数

最初の Time 引数から 2 番目の Time 引数までのナノ秒数を返します。例については、「hoursUntil」を参照してください。

toSecondsOfDay(time: Time)

整数

時刻を秒に変換します。

例

time(1, 0, 0).toSecondsOfDay() は 3600 を返します。

toNanosOfDay(time: Time)

整数

時刻をナノ秒に変換します。

例

time(1, 0, 0).toNanosOfDay() は 3600000000000 を返します。

text(time: Time)

テキスト

Time 値をテキスト表現に変換します。

例

text(time: Time, pattern: Text)

テキスト

Time 値を、指定したパターンに一致するテキスト表現に変換します。

例

text(time(10, 15, 00), "hh:m a") は 10:15 AM を返します。

text(time: Time, pattern: Text, locale: Text)

テキスト

Time 値を、指定したパターンとロケールに一致するテキスト表現に変換します。

例

text(time(10, 15, 00), "hh:m a", "de-DE") は 10:15 vorm を返します。

ampersandEncode(text: Text)

テキスト

テキストをアンバンサンド エンコードします。

例

ampersandEncode("&") は & を返します。

ampersandDecode(text: Text)

テキスト

テキストをアンバンサンド デコードします。

例

ampersandDecode(">") は > を返します。

base64Encode(binary: Binary)

テキスト

MIME (RFC 2045) 用の Base64 転送エンコードを使用する Base64 エンコード。

例

binary.base64Encode()。ここで、binary はバイナリ値を持つ変数です。

base64Decode(text: Text)

バイナリ

MIME (RFC 2045) 用の Base64 転送エンコードを使用する Base64 デコード。

例

base64Decode("SGVsbG8=").text("UTF8") は Hello を返します。

boolean(text: Boolean)

ブール値

テキストは「true」または「false」のいずれかに一致する必要があります。

例

boolean(false:Boolean) は false を返します。

integer(Number)

整数

数値は 1.0 などの整数値である必要があります。

integer(Text)

整数

テキストは、"42" などの整数のテキスト表現である必要があります。

number(Integer)

数値

Number(17) は 17.0 を返します。

number(Text)

数値

テキストは、"17.7" などの数字のテキスト表現である必要があります。

text(Integer)

テキスト

text(Number)

テキスト

text(Boolean)

テキスト

text(binary: Binary, charsetName: Text)

テキスト

テキストの二進表現をテキスト タイプの値に変換します。UTF8 などの文字セットを引数として指定します。

binary(text: Text, charsetName: Text)

バイナリ

テキスト値をバイナリ値に変換します。UTF8 などの文字セットを引数として指定します。

例

"Hello".binary("UTF8").text("UTF8") は Hello を返します。ここで、 "Hello".binary("UTF8") は UTF8 文字エンコードを使用してエンコードされたバイナリ値に評価されます。例のようにバイナリ値がテキストに変換される場合、バイナリ値は同じ文字エンコード (この場合は UTF8) を使用してエンコードする必要があります。

toJSON()

パスワード以外のあらゆるタイプの値を、JSON オブジェクトとしてフォーマットされたテキスト値に変換します。パスワード タイプ属性を含むレコード タイプは JSON に変換できません。

変換された値の例

• 5 は "5" となります

• 1.2 は "1.2" となります

• true は "true" となります

• "Hello" は "\"Hello\"" となります

• バイナリ値は、バイナリ値の Base 64 エンコードになります

• レコード値、R(a = 5, b = true, t = "Hello") は "{\"a\":5,\"b\":true,\"t\":\"Hello\"" となります

toJSON 関数は、[1,2,3] のような配列を生成することはありせん。ロボットで JSON 値を使用する場合は、文字列を連結することによりリストを作成できます。このようにすると、ロボットからベーシック エンジン ロボットに値を返すことができます。

詳細については、JSON の使用を参照してください。

bin は "Hello".binary("ASCII") の結果のバイナリ値を保持している変数です

• "true".boolean()
• "false".boolean()
• "False".boolean()

• Boolean true

• Boolean false

• 「true」または「false」のいずれにも一致しないため、ConversionIssue 例外をスローします

• integer(2.0) または 2.0.integer()

• integer("2") または "2".integer

• number(2) または 2.number()

• number("2") または "2".number()

ここで "Hello".binary("UTF8") は UTF8 文字エンコードを使用してエンコードされたバイナリ値と評価します。例のようにバイナリ値がテキストに変換される場合、バイナリ値は同じ文字エンコード (この場合は UTF8) を使用してエンコードする必要があります。

ここで"Company"はテキストタイプ、整数タイプ、ブールのフィールド タイプを含むレコード タイプの変数です。

次の値のテキスト値:

{"name":"Acme Corp.", "url":"www.acme-corp.com", "revenue":1000000000, "CEO":"Marvin Acme", "fictional":true}