Boost 之date

素颜马尾好姑娘i 2022-06-02 08:18 150阅读 0赞

date是boost库中date\_time库中处理日期的核心类，它使用32位的整数作为内部存储，以天为单位表示时间点的概念。

要想在vs中使用date类，我们需要引用date类的头文件，引用方式：

#include <boost/date_time/gregorian/gregorian.hpp>
    using namespace boost::gregorian;

至于date类的内部代码我就不贴出来了，大家可以自己去看下，也不多。

既然我们导入了头文件，也指定了对应的命名空间，那么我们就开始看下它的简单使用。

首先，我们构造一个默认的date对象，看下它的输出是什么？

date boos_date;
    cout << boos_date << endl;

输出：

not-a-date-time

哦，这是什么意思，看字面意思似乎提示我们这是一个无效的日期吧。那么我们就去看一下not-a-date-time到底是什么东西。

在special\_defs.hpp中我找到了它的定义：

namespace boost { 
    namespace date_time { 
    
        enum special_values {not_a_date_time, 
                             neg_infin, pos_infin, 
                             min_date_time,  max_date_time,
                             not_special, NumSpecialValues};
    
    
    } } //namespace date_time

可以看到，这是一个枚举类型，那么我就一个一个的试着用这些值来构建date对象，让大家能有一个直观的认识，这些值到底表示什么意思。

date date1(not_a_date_time);
        date date2(neg_infin);
        date date3(pos_infin);
        date date4(min_date_time);
        date date5(max_date_time);
        date date6(not_special);
    
        cout << date1 << endl;
        cout << date2 << endl;
        cout << date3 << endl;
        cout << date4 << endl;
        cout << date5 << endl;
        cout << date6 << endl;

在上面我们定义了六个对象，并且直接输出该对象，下面是程序运行结果，注释我顺便写了代表的意思。

not-a-date-time//无效日期
    -infinity//负无限日期
    +infinity//正无限日期
    1400-Jan-01//最小可能日期：1400-01-01
    9999-Dec-31//最大可能日期：9999-12-31
    not-a-date-time//无效日期

接下来我们在看下date的构造方法，它有好几个构造函数，这里简单的列几个，上面的不太常用的，一般适用于无限期的日期情景。

1.缺省构造日期  
语法：date date1  
2.使用数字构造日期  
语法：date2(2018,1,18)  
原型： date(year\_type y, month\_type m, day\_type d)  
3.使用英文指定月份来构造，用法和2相同  
语法：date date3(2018,Jan, 18)  
4.拷贝构造  
语法： date date4(date2) //传入date对象

如果你在代码中分别定义了和我一样的对象并且输出的话，那么会得到下面的结果：

not-a-date-time
    2018-Jan-18
    2018-Jan-18
    2018-Jan-18

当然了，还要一提的是从字符串中定义日期的方法：

//使用分割符号：/ 或者 -
    date date5 = from_string("2017/12/30");
    //纯数字字符串
    date date6 = from_undelimited_string("20171230");

上面的方式也是很有用的，至于具体的实现大家可以去看看源代码，字符串的基本操作。

通过上面的例子我们也知道了怎们去创建date对象，直接使用无参数的date构造对象时产生的是一个无效的日期，那么我们该怎么避免这种情况呢？

答案是使用宏定义，在我们引入命名空间之前使用：

#ifndef DATE_TIME_NO_DEFAULT_CONSTRUCTOR
    #define DATE_TIME_NO_DEFAULT_CONSTRUCTOR
    #endif // !DATE_TIME

DATE\_TIME\_NO\_DEFAULT\_CONSTRUCTOR禁止编译器创造出date的缺省构造函数，强制它们在构造时必须有一个有效的值，可以避免某些疏忽而导致的错误。

这样的话你在初始化的时候，date date1这种写法就通不过编译了额。

在我们写代码的时候难免会出现很多异常，如果我们在构造date对象的时候写入了一个非法的日期，比如没有32天，我就写20171232，那么会出现什么现象，很不幸，这里程序会直接崩溃的。

![这里写图片描述][SouthEast]

如果你对自己写的不太放心，或者是处于安全考虑，那么加一个捕获异常的语句就写的很必要了。

try
        { date date_invalid(2018, 1, 32); }
        catch (exception e)
        { cout << e.what() << endl; }

看下运行结果吧：

Day of month value is out of range 1..31

程序正常运行了，就是结果和我们想的不一样，，哦，日期超出了有效范围。。我改。。。

日期对象我们会创建了，那么我们该怎么使用了呢？

这里我直接通过代码来示例：

date date1(2018, 1, 8);
    
            cout <<"date1.year:" << date1.year() << endl;
            cout << "date1.day_of_year:" << date1.day_of_year() << endl;
    
            cout << "date1.month:" << date1.month() << endl;
            cout << "date1.end_of_month:" << date1.end_of_month() << endl;
            cout << "date1.modjulian_day:" << date1.modjulian_day() << endl;
    
            cout << "date1.day:" << date1.day() << endl;
            cout << "date1.day_count:" << date1.day_count() << endl;
            cout << "date1.day_number:" << date1.day_number() << endl;
            cout << "date1.day_of_week:" << date1.day_of_week() << endl;
    
            cout << "date1.julian_day:" << date1.julian_day() << endl;
    
    
            cout << "date1.is_not_a_date:" << date1.is_not_a_date() << endl;
            cout << "date1.is_infinity:" << date1.is_infinity() << endl;
            cout << "date1.is_neg_infinity:" << date1.is_neg_infinity() << endl;
            cout << "date1.is_pos_infinity:" << date1.is_pos_infinity() << endl;
            cout << "date1.is_special:" << date1.is_special() << endl;

输出结果：

date1.year:2018//哪一年
    date1.day_of_year:8//该年第几天
    date1.month:Jan//该年第几个月
    date1.end_of_month:2018-Jan-31 //当月的最后一天
    date1.modjulian_day:58126 //儒略日数
    date1.day:8 //哪一天
    date1.day_count:2458127//公历第多少天
    date1.day_number:2458127
    date1.day_of_week:Mon //星期几
    date1.julian_day:2458127//公历第多少天
    
    //检测是否为特殊日期的函数
    date1.is_not_a_date:0 //是否是一个无效的日期
    date1.is_infinity:0 //是否是一个无限日期
    date1.is_neg_infinity:0 //是否是一个父无限日期
    date1.is_pos_infinity:0 //是否是一个正无限日期
    date1.is_special:0 //是否是一个任意特殊日期

当然了，还有一个重要的函数要说一下，那就是year\_month\_day()，该函数返回一个date::ymd\_type类型的值，我们可以从它里面一次性的获取年月日信息。

date::ymd_type ymd = date1.year_month_day();
            cout << "year:" << ymd.year << endl;
            cout << "month:" << ymd.month << endl;
            cout << "day:" << ymd.day << endl;

输出：

year:2018
    month:Jan
    day:8

看到这里，我们又得提一下该怎么格式化输出日期格式以达到我们想要的形式。在boost中提供3个函数供我们使用：

1.to\_simple\_string(date d)  
返回yyyy-mmm-dd形式的字符串，其中mmm格式是3字符的英文月份。  
2.to\_iso\_string(date d)  
返回yyyymmdd格式的数字字符串  
3.to\_iso\_extended\_string(date d)  
返回yyyy-mm-dd格式的数字字符串。

实例：

cout <<" to_simple_string(date1):" << to_simple_string(date1) << endl;
            cout << " to_iso_string(date1):" << to_iso_string(date1) << endl;
            cout << " to_iso_extended_string(date1):" << to_iso_extended_string(date1) << endl;

输出：

to_simple_string(date1):2018-Jan-08
     to_iso_string(date1):20180108
     to_iso_extended_string(date1):2018-01-08

个人还是喜欢第三者，符合我们的阅读习惯。。。。。

date对象可以和c++标准的tm结构体相互转化。其中用到的两个函数分别是：to\_tm(date)，date\_from\_tm(tm)。  
值得注意的是date对象只有年月日信息，转化为tm结构时，除了这三个信息，时分秒等信息均被置为0，夏令时标识为-1标识未知。

tm t = to_tm(date1); date date2 = date_from_tm(t);

[SouthEast]: /images/20220602/0175e7c386514adb8305b7dad613f481.png