RTIME( ) 関数

R の関数またはスクリプトによって計算された時刻値を返します。R によるデータ処理は Analytics の外部で行われます。

構文

RTIME(rScript|rCode <,フィールド|値 <,...n>>)

パラメーター

名前 種類 説明
rScript | rCode

文字

実行する R コードのスニペットまたは R スクリプトの絶対または相対パス。

外部ファイルを使用せずに直接 R コードを入力する場合、コード内では、前後の引用符文字はエスケープしても使用することはできません。

  • 有効 'var <- "\"test\"" '
  • 無効 'var <- "\'test\'" '
フィールド|値 <,...n>

省略可能

文字

数値

日付時刻

論理

R スクリプトまたは R コード スニペットの引数として使用するフィールド、式、リテラル値から成るリスト。

値は呼び出す関数に指定順に渡されます。また、値を参照するには、R コード内で「value1, value2 ... valueN」を使用します。

R コードの関数定義を満たすのに必要な数の引数を指定できます。

メモ

文字入力から先頭と末尾の空白を除去するには、ALLTRIM(str) のように ALLTRIM() 関数を使用します。詳細については、ALLTRIM( ) 関数を参照してください。

出力

日付時刻。

基本的な例

`t0545` が返されます。

RTIME("value1+2700",`t0500`)

高度な例

外部 R スクリプトを使用する

次の例では、外部 R 関数にフィールドとリテラル値を渡すことで、45 分が時刻フィールドに加算されます。

RTIME("a<-source('c:\\scripts\\sample.r');a[[1]]", end_time, 2700)

外部 R スクリプト(sample.r):

add_time <- function(start, sec) {
    return(start + sec)
}
add_time(value1, value2)

備考

R からデータを返す

R スクリプトを呼び出す場合、source 関数を使用して、戻りオブジェクトを変数に割り当てます。次に、R 関数から返されて戻りオブジェクトに格納された値に、次のようにアクセスできます。

# 'a' はレスポンス オブジェクトを格納し、a[[1]] はデータ値にアクセスしています
"a<-source('c:\\scripts\\r_scripts\\sample.r');a[[1]]"

R のログ ファイル

R 言語のメッセージは、Analytics によりプロジェクト フォルダーの aclrlang.log ファイルに記録されます。このファイルを使って、R のエラーをデバッグします。

ヒント

ログ ファイルは Analytics Exchange のアナリティクス ジョブの結果フォルダーにあります。

AX Server での外部 R スクリプトの実行

AX Server で実行する分析アプリを作成していて、外部の R スクリプトを使用したい場合は、次の手順を実行します。

  1. 分析アプリとともに、このファイルを関連ファイルとしてアップロードします。
  2. このファイルを指定する際、FILE ANALYTIC タグを使用します。
  3. ファイルの参照には、相対パス ./filename.r を使用します。

メモ

関連ファイルを使用することで、Analytics Exchange とともに R を実行する際に、TomEE アプリケーション サーバーのアカウントに、このファイルにアクセスするための十分な権限が与えられます。

システム タイムゾーン

グリニッジ標準時(GMT)は、Analytics で使用される R 環境のデフォルトの現在のタイムゾーンです。

ACL のスクリプト作成ガイド 14.1