R×lubridate::yq 年四半期の順に並んでいる文字列または数値を日付型に変換する

R言語で、年四半期の順に並んでいる文字列または数値を日付型に変換する方法について解説します。時間に関する処理はtidyverseパッケージに含まれているlubridateパッケージを使うのがとても便利です。ここでは、lubridateパッケージのyq()の使用方法についてお伝えします。

yq()を使用する利点は、2000.1や2000年1などの区切りの仕方の差異や、月が英語表記なども、おおよそ正しく認識できることです。下記の具体例を参照ください。

yq()を使用した時の戻り値の日は1日になります。

yq()の概要

yq()は、年四半期の順に並んでいる文字列または数値を日付型に変換するための関数です。yq()は、文字ベクトルと数値ベクトルに格納されている日付をDateまたはPOSIXctオブジェクトに変換します。これらの関数は、任意の非数字区切り記号と区切り記号なしを認識します。形式の順序が正しい限り、入力ベクトルに異なる形式の日付が含まれている場合でも、これらの関数は日付を正しく解析します。

yq()の使い方

yq(
  ...,
  quiet = FALSE,
  tz = NULL,
  locale = Sys.getlocale("LC_TIME"),
  truncated = 0
)

yq()の引数

日付としている文字または数値ベクトルを指定します。

TRUEの場合、関数は通常のメッセージを表示せずに評価されます。

タイムゾーンインジケーターを指定します。
NULL(デフォルト)の場合、Dateオブジェクトが返されます。それ以外の場合は、タイムゾーン属性がtzに設定されたPOSIXctが返されます。

ロケールを指定します。

切り捨てられる形式の数を整数で指定します。

yq()の戻り値

tz引数がNULLでない場合はPOSIXctクラスのベクトル、tzがNULLの場合はDate(デフォルト)を返します。

準備

あらかじめ、tidyverseパッケージを読み込んでおきます。

library(tidyverse)

年四半期の順に並んでいる文字列をdate型に変換する

年四半期の順に並んでいる文字列をdate型に変換するには次のようにします。

yq(c("2000-01", "2000/2", "2000.3", "2000年4"))

[1] "2000-01-01" "2000-04-01" "2000-07-01" "2000-10-01"

年四半期の順に並んでいる文字列をPOSIXctオブジェクトに変換する

年四半期の順に並んでいる文字列をタイムゾーン日本標準時としたPOSIXctオブジェクトに変換するには次のようにします。

yq(c("2000-01", "2000/2", "2000.3", "2000年4"), tz = "Asia/Tokyo")

[1] "2000-01-01 JST" "2000-04-01 JST" "2000-07-01 JST" "2000-10-01 JST"

年四半期の順に並んでいる数値をdate型に変換する

年四半期の順に並んでいる数値をdate型に変換するには次のようにします。

yq(c(200001, 200002, 200003, 200004))

[1] "2000-01-01" "2000-04-01" "2000-07-01" "2000-10-01"

年四半期の順に並んでいる数値をPOSIXctオブジェクトに変換する

年四半期の順に並んでいる数値をタイムゾーン日本標準時としたPOSIXctオブジェクトに変換するには次のようにします。

yq(c(200001, 200002, 200003, 200004), tz = "Asia/Tokyo")

[1] "2000-01-01 JST" "2000-04-01 JST" "2000-07-01 JST" "2000-10-01 JST"