{"id":9315,"date":"2024-03-25T10:08:58","date_gmt":"2024-03-25T10:08:58","guid":{"rendered":"https:\/\/www.modernescpp.com\/?p=9315"},"modified":"2024-03-25T10:08:59","modified_gmt":"2024-03-25T10:08:59","slug":"c20-time-of-day","status":"publish","type":"post","link":"https:\/\/www.modernescpp.com\/index.php\/c20-time-of-day\/","title":{"rendered":"C++20: Time of Day"},"content":{"rendered":"\n

This new data type std::chrono::hh_mm_ss<\/code> in C++20 stands for the time of day.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Time of Day<\/h2>\n\n\n\n

std::chrono::hh_mm_ss<\/code> is the duration since midnight split into hours, minutes, seconds, and fractional seconds. This type is typically used as a formatting tool. First, the following table gives you a concise overview of std::chrono::hh_mm_ss<\/code> instance tOfDay.<\/code><\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Depending on the used time duration, the static member provides the appropriate tOfDay<\/code>.fractional_width<\/code>. If no such value of fractional_width<\/code> in the range [0, 18]<\/code> exists, then fractional_width<\/code> is 6<\/code>. See for example, std::chrono::duration<int, std::ratio<1, 3>><\/code> in the following table.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

The use of the chrono type std::chrono::hh_mm_ss<\/code> is straightforward.<\/p>\n\n\n\n

\/\/ timeOfDay.cpp<\/span>\n\n#include <chrono><\/span>\n#include <iostream><\/span>\n\nint<\/span> main<\/span>() {\n                                                            \n     using<\/span> namespace<\/span> std::<\/span>chrono_literals; \n\n     std::<\/span>cout <<<\/span> std::<\/span>boolalpha <<<\/span> '\\n'<\/span>;\n    \n     auto<\/span> timeOfDay =<\/span> std::<\/span>chrono::<\/span>hh_mm_ss(10.5<\/span>h +<\/span> 98<\/span>min +<\/span> 2020<\/span>s +<\/span> 0.5<\/span>s);         \/\/ (1)<\/span>\n    \n     std::<\/span>cout<<<\/span> "timeOfDay: "<\/span> <<<\/span> timeOfDay <<<\/span> '\\n'<\/span>;                               \/\/ (2)<\/span>\n\n     std::<\/span>cout <<<\/span> '\\n'<\/span>;\n\n     std::<\/span>cout <<<\/span> "timeOfDay.hours(): "<\/span> <<<\/span> timeOfDay.hours() <<<\/span> '\\n'<\/span>;              \/\/ (4)<\/span>\n     std::<\/span>cout <<<\/span> "timeOfDay.minutes(): "<\/span> <<<\/span> timeOfDay.minutes() <<<\/span> '\\n'<\/span>;          \/\/ (4)<\/span>\n     std::<\/span>cout <<<\/span> "timeOfDay.seconds(): "<\/span> <<<\/span> timeOfDay.seconds() <<<\/span> '\\n'<\/span>;          \/\/ (4)<\/span>\n     std::<\/span>cout <<<\/span> "timeOfDay.subseconds(): "<\/span> <<<\/span> timeOfDay.subseconds() <<<\/span> '\\n'<\/span>;    \/\/ (4)<\/span>\n     std::<\/span>cout <<<\/span> "timeOfDay.to_duration(): "<\/span> <<<\/span> timeOfDay.to_duration() <<<\/span> '\\n'<\/span>;  \/\/ (5)<\/span>\n\n     std::<\/span>cout <<<\/span> '\\n'<\/span>;\n\n     std::<\/span>cout <<<\/span> "std::chrono::hh_mm_ss(45700.5s): "<\/span> \n               <<<\/span> std::<\/span>chrono::<\/span>hh_mm_ss(45700.5<\/span>s) <<<\/span> '\\n'<\/span>;                          \/\/ (6)<\/span>\n\n     std::<\/span>cout <<<\/span> '\\n'<\/span>;\n\n     std::<\/span>cout <<<\/span> "std::chrono::is_am(5h): "<\/span> <<<\/span> std::<\/span>chrono::<\/span>is_am(5<\/span>h) <<<\/span> '\\n'<\/span>;     \/\/ (7)    <\/span>\n     std::<\/span>cout <<<\/span> "std::chrono::is_am(15h): "<\/span> <<<\/span> std::<\/span>chrono::<\/span>is_am(15<\/span>h) <<<\/span> '\\n'<\/span>;   \/\/ (7)<\/span>\n\n     std::<\/span>cout <<<\/span> '\\n'<\/span>;\n     \n     std::<\/span>cout <<<\/span> "std::chrono::make12(5h): "<\/span> <<<\/span> std::<\/span>chrono::<\/span>make12(5<\/span>h) <<<\/span> '\\n'<\/span>;   \/\/ (7)   <\/span>\n     std::<\/span>cout <<<\/span> "std::chrono::make12(15h): "<\/span> <<<\/span> std::<\/span>chrono::<\/span>make12(15<\/span>h) <<<\/span> '\\n'<\/span>; \/\/ (7) <\/span>\n\n}\n<\/pre><\/div>\n\n\n\n
In line (1), I create a new instance of std::chrono::hh_mm_ss: timeOfDay<\/code>. Thanks to the chrono literals from C++14, I can add a few time durations to initialize a time-of-day object. With C++20, you can directly output timeOfDay<\/code> (line 2). The rest should be straightforward to read. Lines (4) display the components of the time since midnight in hours, minutes, seconds, and fractional seconds. Line (5) returns the time duration since midnight in seconds. Line (6) is more interesting: the given seconds correspond to the time displayed in line (2). Line (7) returns if the given hour is a.m. Line (8) finally returns the 12-hour equivalent of the given hour.<\/p>\n\n\n\n
Here is the output of the program:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Calendar Date<\/h2>\n\n\n\n
A new type of the chrono extension in C++20 is a calendar date. C++20 supports various ways to create a calendar date and interact with them. First of all: What is a calendar date?<\/p>\n\n\n\n
    \n
  •  A calendar date<\/strong> consists of a year, a month, and a day. Consequently, C++20 has a specific data type std::chrono::year_month_day<\/code>. C++20 has way more to offer. The following table should give you an overview of calendar types before I show you various use cases.<\/li>\n<\/ul>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    Thanks to the cute syntax, you can use  std::chrono::operator \/<\/code> to create Gregorian calendar dates.<\/p>\n\n\n\n
    The calendar data types support various operations. The following table gives an overview. For readability reasons, I partially ignore the namespace std::chrono<\/code>.<\/p>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    The increment and decrement operations ++\/--<\/code> are supported in the prefix and postfix version. Adding or subtraction +\/-<\/code> requires objects of type std::chrono::duration<\/code>. That means when you build the difference of two objects of calendar type std::chrono::day<\/code> you get an object of type std::chrono::days. <=><\/code> is the new three-way comparison operator.<\/p>\n\n\n\n
    The following program uses the operations on the calendar types.<\/p>\n\n\n\n
    \/\/ calendarOperations.cpp<\/span>\n\n#include <chrono><\/span>\n#include <iostream><\/span>\n\nint<\/span> main<\/span>() {\n\n  std::<\/span>cout <<<\/span> '\\n'<\/span>;\n\n  using<\/span> std::<\/span>chrono::<\/span>Monday;\n  using<\/span> std::<\/span>chrono::<\/span>Saturday;\n\n  using<\/span> std::<\/span>chrono::<\/span>March;\n  using<\/span> std::<\/span>chrono::<\/span>June;\n  using<\/span> std::<\/span>chrono::<\/span>July;\n\n  using<\/span> std::<\/span>chrono::<\/span>days;\n  using<\/span> std::<\/span>chrono::<\/span>months;\n  using<\/span> std::<\/span>chrono::<\/span>years;\n\n  using<\/span> std::<\/span>chrono::<\/span>last;\n\n  using<\/span> namespace<\/span> std::<\/span>chrono_literals;\n\n  std::<\/span>cout <<<\/span> std::<\/span>boolalpha;\n\n  std::<\/span>cout <<<\/span> "March: "<\/span> <<<\/span> March <<<\/span> '\\n'<\/span>;                                            \n  std::<\/span>cout <<<\/span> "March + months(3): "<\/span> <<<\/span> March +<\/span> months(3<\/span>) <<<\/span> '\\n'<\/span>;                      \/\/ (1)<\/span>\n  std::<\/span>cout <<<\/span> "March - months(25): "<\/span> <<<\/span> March -<\/span> months(25<\/span>) <<<\/span> '\\n'<\/span>;                    \/\/ (5)  <\/span>\n  std::<\/span>cout <<<\/span> "July - June: "<\/span> <<<\/span>  July -<\/span> June <<<\/span> '\\n'<\/span>;                                 \/\/ (6)<\/span>\n  std::<\/span>cout <<<\/span> "June < July: "<\/span> <<<\/span> (June <<\/span> July) <<<\/span> '\\n'<\/span>;                                \/\/ (7)<\/span>\n\n  std::<\/span>cout <<<\/span> '\\n'<\/span>;\n \n  std::<\/span>cout <<<\/span> "Saturday: "<\/span> <<<\/span> Saturday <<<\/span> '\\n'<\/span>;\n  std::<\/span>cout <<<\/span> "Saturday + days(3): "<\/span> <<<\/span> Saturday +<\/span> days(3<\/span>) <<<\/span> '\\n'<\/span>;                    \/\/ (2)<\/span>\n  std::<\/span>cout <<<\/span> "Saturday - days(22): "<\/span> <<<\/span> Saturday -<\/span> days(22<\/span>) <<<\/span> '\\n'<\/span>;                  \/\/ (8)<\/span>\n  std::<\/span>cout <<<\/span> "Saturday - Monday: "<\/span> <<<\/span>  Saturday -<\/span> Monday <<<\/span> '\\n'<\/span>;                     \/\/ (9)<\/span>\n\n  std::<\/span>cout <<<\/span> '\\n'<\/span>;\n\n  std::<\/span>cout <<<\/span> "2021y\/March: "<\/span> <<<\/span> 2021<\/span>y\/<\/span>March <<<\/span> '\\n'<\/span>;                                  \/\/ (3)<\/span>\n  std::<\/span>cout <<<\/span> "2021y\/March + years(3) - months(35): "<\/span>                                  \/\/ (10)<\/span>\n            <<<\/span> 2021<\/span>y\/<\/span>March +<\/span> years(3<\/span>) -<\/span> months(35<\/span>) <<<\/span> '\\n'<\/span>;\n  std::<\/span>cout <<<\/span> "2022y\/July - 2021y\/June: "<\/span> <<<\/span> 2022<\/span>y\/<\/span>July -<\/span> 2021<\/span>y\/<\/span>June <<<\/span> '\\n'<\/span>;         \/\/ (11)<\/span>\n  std::<\/span>cout <<<\/span> "2021y\/June > 2021y\/July: "<\/span> <<<\/span> (2021<\/span>y\/<\/span>June ><\/span> 2021<\/span>y\/<\/span>July) <<<\/span> '\\n'<\/span>;       \/\/ (12)<\/span>\n\n  std::<\/span>cout <<<\/span> '\\n'<\/span>;\n\n  std::<\/span>cout <<<\/span> "2021y\/March\/Saturday[last]: "<\/span> <<<\/span> 2021<\/span>y\/<\/span>March\/<\/span>Saturday[last] <<<\/span> '\\n'<\/span>;   \/\/ (4)<\/span>\n  std::<\/span>cout <<<\/span> "2021y\/March\/Saturday[last] + months(13) + years(3): "<\/span> \n            <<<\/span> 2021<\/span>y\/<\/span>March\/<\/span>Saturday[last] +<\/span> months(13<\/span>) +<\/span> years(3<\/span>) <<<\/span> '\\n'<\/span>;\n  std::<\/span>cout <<<\/span> "2021y\/July\/Saturday[last] - months(1) == 2021y\/June\/Saturday[last]: "<\/span>\n            <<<\/span> (2021<\/span>y\/<\/span>July\/<\/span>Saturday[last] -<\/span> months(1<\/span>) ==<\/span> 2021<\/span>y\/<\/span>June\/<\/span>Saturday[last]) \n            <<<\/span> '\\n'<\/span>;\n\n  std::<\/span>cout <<<\/span> '\\n'<\/span>;\n\n}\n<\/pre><\/div>\n\n\n\n
    The program performs operations on std::chrono::month<\/code> (line 1), std::chrono::weekday<\/code> (line 2), std::chrono::year_month <\/code>(line 3), and std::chrono::year_month_weekday_last<\/code> (line 4).<\/p>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    Adding or subtracting the time duration std::chrono::months<\/code> automatically applies modulo operations (lines 5 and 6). Subtracting two std::chrono::month<\/code> objects returns 1<\/code> month. One month has 2629746<\/code> seconds (line 7). Accordingly, you can add or subtract a time duration std::chrono::days<\/code> to or from a calendar data std::chrono::day<\/code> (lines 8 and 9). Subtracting two std::chrono::day<\/code> objects returns a std::chrono::days<\/code> object. std::chrono::year_month<\/code> allows the subtraction (line 10), the difference (line 11), and the comparison of time points (line 12). Objects of type std::chrono::weekday_last<\/code> allow the addition\/subtraction of the time durations std::chrono::months<\/code> and std::chrono::years<\/code>. In addition, these std::chrono::weekday_last<\/code> objects can be compared.<\/p>\n\n\n\n
    What’s Next?<\/h2>\n\n\n\n
    C++20 supports constants and literals to make using calendar-date types more convenient.<\/p>\n","protected":false},"excerpt":{"rendered":"
    This new data type std::chrono::hh_mm_ss in C++20 stands for the time of day. Time of Day std::chrono::hh_mm_ss is the duration since midnight split into hours, minutes, seconds, and fractional seconds. This type is typically used as a formatting tool. First, the following table gives you a concise overview of std::chrono::hh_mm_ss instance tOfDay. Depending on the […]<\/p>\n","protected":false},"author":21,"featured_media":9316,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[375],"tags":[453],"class_list":["post-9315","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-c-20","tag-time"],"_links":{"self":[{"href":"https:\/\/www.modernescpp.com\/index.php\/wp-json\/wp\/v2\/posts\/9315","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.modernescpp.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.modernescpp.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.modernescpp.com\/index.php\/wp-json\/wp\/v2\/users\/21"}],"replies":[{"embeddable":true,"href":"https:\/\/www.modernescpp.com\/index.php\/wp-json\/wp\/v2\/comments?post=9315"}],"version-history":[{"count":30,"href":"https:\/\/www.modernescpp.com\/index.php\/wp-json\/wp\/v2\/posts\/9315\/revisions"}],"predecessor-version":[{"id":9363,"href":"https:\/\/www.modernescpp.com\/index.php\/wp-json\/wp\/v2\/posts\/9315\/revisions\/9363"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.modernescpp.com\/index.php\/wp-json\/wp\/v2\/media\/9316"}],"wp:attachment":[{"href":"https:\/\/www.modernescpp.com\/index.php\/wp-json\/wp\/v2\/media?parent=9315"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.modernescpp.com\/index.php\/wp-json\/wp\/v2\/categories?post=9315"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.modernescpp.com\/index.php\/wp-json\/wp\/v2\/tags?post=9315"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}