最終更新日時: 2017年12月25日 04時40分03秒
Akira Takahashi が更新

posix_time::ptime Documentation

ptime Documentation

Introduction

boost::posix_time::ptime クラスは時間位置(time point)を操作するための主要なインタフェースである。一般に，ptime クラスは代入可能ではあるが，一度構築されると不変である事が多い。

クラス ptime は，時間位置(time point)の日付部分へのインタフェースである gregorian::date に依存する。

ptime を生成する別の手法が，time iterators にある。

#include "boost/date_time/posix_time/posix_time.hpp" //全ての型とI/Oを含む

もしくは

#include "boost/date_time/posix_time/posix_time_types.hpp" //型のみでI/Oは含まない

Syntax	Description	Example
`ptime(date,time_duration)`	日付とオフセットから構築	`ptime t1(date(2002,Jan,10), time_duration(1,2,3));` `ptime t2(date(2002,Jan,10), hours(1)+nanosec(5));`
`ptime(ptime)`	コピーコンストラクタ	`ptime t3(t1)`

Syntax	Description	Example
`ptime time_from_string(const std::string&)`	区切られた文字列から構築	`std::string ts("2002-01-20 23:59:59.000");` `date d(time_from_string(ts));`

Syntax	Description	Example
`static ptime second_clock::local_time();`	計算機の時間帯設定に基づいた地域時間(秒レベル分解能)で初期化	`ptime t(second_clock::local_time());`
`static ptime second_clock::universal_time()`	UTC 時間で初期化	`ptime t(second_clock::universal_day());`

Syntax	Description	Example
`date date() const`	時間の日付部分を取得	`date d(2002,Jan,10);` `ptime t(d, hour(1));` `t.date() --> 2002-Jan-10;`
`time_duration time_of_day() const`	その日の時間オフセットを取得	`date d(2002,Jan,10);` `ptime t(d, hour(1));` `t.time_of_day() --> 01:00:00;`

Syntax	Description	Example
`std::string to_simple_string(ptime)`	YYYY-mmm-DD HH:MM:SS.fffffffff 形式の文字列(mmm は月名の3文字短縮名)に変換。秒の小数部(.fffffffff)は0でないとき含まれる。	2002-Jan-01 10:00:01.123456789
`std::string to_iso_string(ptime)`	YYYYMMDDTHHMMSS,fffffffff 形式(T は日付と時間の区切り) に変換	20020131T100001,123456789
`std::string to_iso_extended_string(ptime)`	YYYY-MM-DDTHH:MM:SS,fffffffff 形式(T は日付と時間の区切り) に変換	2002-01-31T10:00:01,123456789

Syntax	Description	Example
`operator==, operator!=,` `operator>, operator<` `operator>=, operator<=`	サポートする比較演算子	`t1 == t2`, etc
`ptime operator+(date_duration) const`	オフセット日数(`date_duration`)を加えた `ptime` を返す	`date d(2002,Jan,1);` `ptime t(d,minutes(5));` `date_duration dd(1);` `ptime t2 = t + dd;`
`ptime operator-(date_duration) const`	オフセット日数(`date_duration`)を差し引いた `ptime` を返す	`date d(2002,Jan,1);` `ptime t(d,minutes(5));` `date_duration dd(1);` `ptime t2 = t - dd;`
`ptime operator+(time_duration) const`	時間長(`time_duration`)を加えた `ptime` を返す	`date d(2002,Jan,1);` `ptime t(d,minutes(5));` `ptime t2 = t + hours(1) + minutes(2);`
`ptime operator-(time_duration) const`	時間長(`time_duration`)を差し引いた `ptime` を返す	`date d(2002,Jan,1);` `ptime t(d,minutes(5));` `ptime t2 = t - minutes(2);`
`time_duration operator-(ptime) const`	二つの時間の差を取る	`date d(2002,Jan,1);` `ptime t1(d,minutes(5));` `ptime t2(d,seconds(5));` `time_duration t3 = t2 - t1;//negative result`