式参照 V1

Pre-19R1

Vault CDMS の式と表現文法で使用可能な関数と演算子、日付形式、数値形式の詳細については、以下の表を参照してください。

関数と演算子

構文 説明
論理演算子
< より小さい
<= 次と等しいか小さい
> より大きい
>= 次と等しいか大きい
numberEquals(number1, number2) 両方の数値引数 (式を含めることができる) が等しい場合に true を返します。
textEquals(text1, text2) 両方のテキスト (文字列) 引数が等しい場合に true を返します。
&& および (AND)
|| または
算術演算子
* 2 つの値を掛けます.
/ 1 つの値をもう 1 つの値で割ります.
% もう 1 つの値で割った値の剰余.
+ 2 つの値の合計を計算します.
- 2 つの値の差を計算します.
演算機能
min(number1, number2 ...) 集合から最小の数を返します。
max(number1, number2, ...) 集合から最大の数を返します.
sqrt(number) 平方根を返します。
floor(number) 値 (number) の次に大きい整数を返します。
ceiling(number) 値 (number) の次に小さい整数を返します。
round(number_of_digits) 値を定義された数字で四捨五入します。
value(text) 文字列 (text) を数値として返します。
論理関数
and(expression1, expression2, ...) 両方の条件が True の場合に True を返します。
or(expression1, expression2, ....) 条件の 1 つだけが true の場合に true を返します。
not(expression) 条件が true ではない場合に True を返します。
if(expression1, value1, value2) 式が True の場合は value 1 を返し、式が False の場合は value 2 を返します。
isNumber(text) 値が数字の場合に True を返します.
isNull(expression) 値が Null の場合に True を返します。
picklistEquals(, Picklist.<選択リスト名>。) 選択リスト値を既存のグローバル選択リスト ラベル値と比較しTtrue または False を返します。
isBlank(expression) 値が空白の場合に True を返します.
値関数
case(expression1, match1, result1, match2, result2, else_result) 式の値を各の一致する値 (match) と比較して対の結果を返します。一致する値がない場合、この関数は最後 (else) の引数を返します。
ifBlank(expression1, expression2) 最初の引数 (expression1) が空白の場合、この関数は 2 番目の引数 (expression2) を返します。空白ではない場合、この関数は最初の引数 (expression1) を返します。
ifNull(expression1, expression2) 最初の引数 (expression1) が Null の場合、この関数は 2 番目の引数 (expression2) を返します。Null ではない場合、この関数は最初の引数 (expression1) を返します。
テキスト関数
upper(value) テキスト (value) を UPPERCASE に変更します。
lower(value) テキスト (value) を lowercase に変更します。
left(value, pos) 左側の指定された位置 (pos) から始まる、指定されたテキスト文字数 (value) を返します。
right(value, pos) 右側の指定された位置 (pos) から始まる、指定されたテキスト文字数 (value) を返します。
middle(value, pos1, pos2) 2 つの指定された位置間のテキスト文字数を返します (pos1 and pos2)。
length(value) 文字の長さを返します。
substitute(value, from, to) 定義済み値を置き換えます
trim(value) 先頭と末尾のスペースを削除します。
text(Date, format_mask) フォーマット (format_mask) を指定日に適用します。
text(Number, format_mask) フォーマット (format_mask) を指定の数字に適用します (式を追加可能)。
Concatenate(text1, text2, ...) この関数はテキスト文字列に使用します。
日付および日時の関数
date(year, month, day) 設定日表記の日付を返します。
day(date) 日付から日を返します。
month(date) 日付から月を返します。
year(date) 日付から年を返します.
today() Vault のタイムゾーンで今日の日付を返します。
now() 現在の日時を返します(UTC)。
時間() 現在の時刻の値を 1 から 23 (UTC) で返します。
minute() 現在の時間の現在の分の値を 1 から 59 (UTC) で返します。
second() 現在の分の現在の秒の値を 1 から 59 (UTC) で返します。
days(number) 間隔として指定された日数を返します.
months(number) 間隔として指定された月数を返します.
years(number) 間隔として指定された年数を返します.
dateDiff(end, start) 2 つの日付の差を日数で返します。この関数は、終了日 (end) から開始日 (start) を減算します。
(EDC) dateDiff は不明な日付を処理できないことに注意してください。スタディ デザインで日付タイプのアイテムに不明な値が許可されている場合は、substitute を使用して不明な日付を日付値に置き換える必要があります。
timeDiff(end, start)) 2 つの時間の差を分数で返します。この関数は、終了時刻 (end) から開始時刻 (start) を減算します。
dateAdd(date, interval) 開始日 (date) からのオフセット (間隔) に基づいて日付を返します。
次の構文を使用して、間隔に日、月、または年を使用できます: days(#), months(#), or years(#)。
たとえば、Audit オブジェクトの式フィールドを使用して、監査終了日を計算できます。終了日は監査開始日の 2 週間後です。
dateAdd(Object.audit_start_date    v, days(14))
dateTimeAdd (datetime,  interval) 開始 DateTime (datetime) からのオフセット (interval) に基づいて DateTime 値を返します。
次の構文を使用して、間隔に日、月、または年を使用できます: days(#), months(#), or years(#)。
dateTimeDiff (end, start) 2 つの DateTime 値の差を日数、時間数、および分数で返します。この関数は、終了 DateTime (end) から開始 DateTime (start) を減算します。
dateInISO(date) 日付 (date) を ISO フォーマットで返します。
dateInISO(datetime) DateTime (datetime) を ISO フォーマットで返します。
Vault 関数
durationInValue フィールドに特定の値がある合計期間を返します。日付または日時フィールドタイプはサポートしていません。現在フィールドがその値である場合、Vault は終了日に現在日を使用します。フィールドに値がない場合、関数は空/空欄を返します。注: この関数は、日数の端数を返します。
previousValue フィールドの現在値の前の値を返します。日付または日時フィールドタイプはサポートしていません。
firstTimeInValue フィールドが特定の値に最初に設定されたときの日時を返します。日付または日時フィールドタイプはサポートしていません。フィールドに値がない場合、関数は空/空欄を返します。
lastTimeInValue フィールドが特定の値に最後に設定されたときの日時を返します。日付または日時フィールドタイプはサポートしていません。フィールドが特定の値であることが数回あっても、フィールドの直近の時間を返します。現在フィールドがその値である場合、関数は現在の日時を返します。フィールドに値がない場合、関数は空/空欄を返します。
numTimesInValue フィールドが特定の値に設定された回数を返します。日付または日時フィールドタイプはサポートしていません。

日付形式

日付形式 日付出力例
d 1 (1 桁の月の日付)
dd 01(2 桁の月の日付)
ddd Thu(3 桁の曜日名)
dddd 木曜日(完全な曜日名)
mm 03(2 桁の月)
mmm 3 月(3 文字の月名)
mmmm 3 月(完全な月名)
yy 17(2 桁の年)
yyyy 2017(完全な年)
dd-mm-yyyy 31-03-2017
yyyymmdd 20170331
dd.mmm.yyyy 30.03.2017
yyyy-mm-dd 2017-03-30
mmmm yyyy March 2017
dddd dd/mm/yy Thursday 31/03/17

番号形式

番号形式 数字入力例 数字出力例
0 10.1 10 (数値そのまま、小数なし)
# 10.10 10 (数値そのまま、小数なし、ゼロなし)
0.00 10.2531 10.25 (小数点第 2 位に四捨五入された数値)
#.## 10.2501 10.25 (小数点第 2 位に四捨五入された数値、ゼロなし)
$# 100 $100 (通貨表記の番号)
#,### 1104 1,104 (左から 3 桁のコンマ付きの数字。複数のコンマを使用可能
- 10 -10 (マイナス記号を式に追加)
% 9 %90 (数値を 10 倍してパーセンテージで表示します)
E 12345 1.234E4 (有効桁数である仮数部と指数部を指数表記で区切る)