Skip to main content

Boost.DateTime - Selected date operations

Today I would like to present you operations related to date and time using Boost.DateTime library. This library contains set of classes, templates and algorithms prepared for date and time related tasks. This article focuses on date operations. Time operations will be presented in one of the future articles.

Example of usage some basic Boost.DateTime date operations you can see here:
Output of this example is (for day 2 January 2014):
All below operations will be based on boost::gregorian namespace. We created alias dateTime for that namespace for more convenient use.

In point I we are using universal_day() method for getting current day according to UTC time zone. Of course output of this and other date-related functions depends on date of invoking. Therefore you will get other output of your application every day you will invoke it.
universal_day() function returns Boost date class object which has lot of functions for date manipulation and displaying.

In point II we are using months class object to add one month to our current date. Thanks to overloading operator+() you can add date and months class objects and iterate through next and previous months. If you will add one month to the date 1-Jan-2014 you will receive 1-Feb-2014. However if you will add one month to date 31-Jan-2013 you will receive 28-Feb-2013 (because all dates are end days of consecutive months).

In point III we are using date_from_iso_string() method for conversion string formatted as "YYYYMMDD" to date class and display its value to standard output.

Point IV presents data_duration class object which allow you calculate time intervals. We are using two our date objects today and myBirthdayDate to calculate interval of live of person who was birth at 30-Jun-1985. Then we are using days() method of date_duration class to present calculated interval as number of days.

Point V present how to iterate through consecutive days using day_iterator class and overloaded operator++(. As you can see this iteration is adequate to mechanism of iteration between consecutive elements of STL containers. Thanks to that we have intuitive way to iterate throgh dates, too.

Of course DateTime library has more useful functions to operate on dates. Lots of details and examples you can find on the offical Boost.DateTime library documentation site here: http://www.boost.org/doc/libs/1_55_0/doc/html/date_time/examples.html

Example from this article you can find on our GitHub account here: https://github.com/xmementoit/CppAdventureExamples/tree/master/boost/dateTime


Comments

  1. Boost is very big and hard to learn library. I appreciate that you would like to explain it here step by step.

    ReplyDelete

Post a Comment

Popular posts from this blog

C++ Multithreading - Race conditions

In the previous C++ Multithreading article I presented you how to pass parameters between threads. Take a detail look on the output of that example once again: In the first line of that output you can notice that output text from two threads is mixed. You are probably wondering why it happens? It is because we are not protecting resources which are shared by two threads (in this example cout stream is shared in both threads) which causes multithreading's phenomenon called race condition . Because threads switching and accessing to shared resources are managed by operating system we do not know when std::cout stream will be accessed by main thread and when it will be accessed by second thread. Therefore in the previous article I mentioned that output of the example can be little different on your computer than my output example. What's more it is possible that this output will be different for few consecutive invoking of the example on the same machine. It is beca...

Advanced C++ - Stack unwinding

Stack unwinding is normally a concept of removing function entries from call stack (also known as Execution stack, Control stack, Function stack or Run-time stack). Call Stack is a stack data structure that stores active functions' addresses and helps in supporting function call/return mechanism. Every time when a function is called, an entry is made into Call stack which contains the return address of the calling function where the control needs to return after the execution of called function. This entry is called by various names like stack frame , activation frame or activation record. With respect to exception handling , stack Unwinding is a process of linearly searching function call stack to reach exception handler. When an exception occurs, if it is not handled in current function where it is thrown, the function Call Stack is unwound until the control reaches try block and then passes to catch block at the end of try block to handle exception. Also, in this proc...

Advanced C++ - Template Functions

Template function are special types of C++ function which can be used with different types (generic types). Thanks to that we can create one body of function which can be used for many different types. When we are creating template function compiler does not define any function for use at that time. Generation of funciton basing on templates are done during compilation process basing of differnt usage of template class. For better understanding take a look on following example: Output of this example is: In point I, we are defining template function which should return sum of two parameters. Without templates we need to define such function separately for each type which we should use it with (ex. separate function for int type, separate for double , separate for any other type). Thanks to template we can generate body of that function only once (as in point I) and use it to any type which is able to use body of that function. In our example we can use this template for an...