R×lubridate::dmy_hms 日月年時分秒の順に並んでいる文字列または数値をPOSIXctオブジェクトに変換する

R言語のlubridateパッケージに含まれているdmy_hms()関数について解説します。この関数は、「海外基準の『日・月・年』の順で、秒単位(またはミリ秒)まで精密に記録されたタイムスタンプを日時型に変えたい」ときに使える関数です。この関数は、「日(Day)→ 月(Month)→ 年(Year)→ 時(Hour)→ 分(Minute)→ 秒(Second)」の順番で並んでいるテキストや数値を、自動で日時オブジェクト(POSIXct型)に変換する関数です。

lubridateパッケージは、日付と時間データを操作するための強力で便利な関数を多く取り扱っています。また、Rのデータサイエンス向け主要パッケージ群であるtidyverseパッケージにも含まれています。

概要

dmy_hms()は、日月年時分秒の順に並んでいる文字列または数値をPOSIXctオブジェクトに変換するための関数です。dmy_hms()は、すべての非英数字区切り文字(frac = TRUEの場合は “.” を除く)を認識し、異種の日付と時刻の表現を正しく処理します。

使い方


dmy_hms(
  ...,
  quiet = FALSE,
  tz = "UTC",
  locale = Sys.getlocale("LC_TIME"),
  truncated = 0
)

引数

年、月、日、時、分、秒の形式で表された日付の文字ベクトルを指定します。

quiet = FALSE

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

tz = NULL

日付を解析するタイムゾーンを指定する文字列を指定します。
文字列は、ユーザーの OS で認識されるタイムゾーンである必要があります。

locale = Sys.getlocale(“LC_TIME”)

ロケールを指定します。
使用するロケールについては、localesを参照してください。Linux システムでは、system(“locale -a”)を使用して、インストールされているすべてのロケールを一覧表示できます。

truncated = 0

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

戻り値

POSIXct日付時刻オブジェクトのベクトルを返します。

使用例

準備

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


# library(tidyverse)でもよい
library(lubridate)

日月年時分秒の順に並んでいる文字列をPOSIXctオブジェクトに変換する

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


dmy_hms(c("01-01-2000 08:15:30", "15-06-2005 12:30:20"), tz = "Asia/Tokyo")

[1] "2000-01-01 08:15:30 JST" "2005-06-15 12:30:20 JST"

日月年時分秒の順に並んでいる数値をPOSIXctオブジェクトに変換する

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


dmy_hms(c(1012000081530, 15062005123020), tz = "Asia/Tokyo")

[1] "2000-01-01 08:15:30 JST" "2005-06-15 12:30:20 JST"

参考文献