@TextToTime (式言語)

文字列を日時値に変換できる場合は、変換します。

構文

@TextToTime( string )

パラメータ

string

文字列または文字列リスト。日時に変換する文字列を指定します。

戻り値

time-date

日時、日時の範囲、または日時の範囲のリスト。string が日時に変換されて返されます。

使用法

パラメータがリストである場合、この関数はリストの各要素ごとに処理され、戻り値は同じ数の要素を持つリストになります。

この関数は、テキストフィールドにある日付を、日時フィールドの計算で使用できる値に変換する場合に便利です。

相対的な日付を表すために使用できる有効な文字列は、"Today"、"Tomorrow"、"Yesterday" のみです。式 @TextToTime("Next week") では、文字列 "Next week" を日時値に変換できないため、空白が返されます。

@TextToTime に、日時値など文字列以外の値を渡すと、エラーが返されます。

例

次の例では、123.45 が返されます。
```
@Text(123.45)
```
次の例では、[Sales] フィールドが 800 のときに、$800.00 が返されます。
```
@Text(Sales;"C,2")
```
次の例では、8.00E+02 が返されます。
```
@Text(800;"S")
```
次の例では、8.00E+02 と -6.00E+02 がリストで返されます。
```
@Text(800 : (-600);"S")
```
次の例では、04/11/93 10:43 AM が返されます。
```
@Text(@Now)
```
次の例では、04/11 が返されます。
```
@Text(@Now;"D1S0")
```
次の例では、10:43:30 AM が返されます。
```
@Text(@Now;"D1S1")
```
次の例では、04/93 10:43 AM が返されます。
```
@Text(@Now;"D3T1")
```
次の例では、リッチテキストの [本文] フィールドの内容から添付ファイルと書式を除いた文字列が返されます。
```
@Text(Body)
```

[ShipDate] フィールドに格納されている数値の日付を文字の日付に変換するには、次のコードを使用します。[ShipDate] の内容が [08/31/2002] ならば、結果は「August 31, 2002」となります。

@If( @IsTime(ShipDate); 
@Text(@Select(@Month(ShipDate); "January"; "February"; "March"; "April"; "May"; "June"; "July"; "August"; "September"; "October"; "November";  "December"))  + " " +
@Text(@Day(ShipDate)) + ", " + @Text(@Year(ShipDate));
 "No date given")

クロスリファレンス

LotusScript® 言語の DateValue 関数

LotusScript 言語の TimeValue 関数

LotusScript 言語の CDat 関数