Namespaces
Variants
Views
Actions

std::chrono::time_zone::to_local

From cppreference.com
< cpp‎ | chrono‎ | time zone
 
C++
 
Date and time library
Time point
(C++11)
(C++20)  
(C++20)
Duration
(C++11)
Clocks
(C++11)
(C++11)
(C++20)
(C++20)
(C++20)
(C++11)
(C++20)
(C++20)
(C++20)
Time of day
(C++20)(C++20)
(C++20)(C++20)
(C++20)
Calendar
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)  
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
chrono I/O
(C++20)

 
std::chrono::time_zone
Member functions
time_zone::to_local
Nonmember functions
 
template< class Duration >

auto to_local( const std::chrono::sys_time<Duration>& tp ) const

    -> std::chrono::local_time<std::common_type_t<Duration, std::chrono::seconds>>;
 (since C++20)

Converts the sys_time tp to the corresponding local_time in this time zone.

Contents

[edit] Parameters

tp - a time point to be converted

[edit] Return value

The local_time associated with tp and this time zone.

[edit] Notes

The precision of the result is at least std::chrono::seconds, and will be finer if the argument has finer precision.

[edit] Example

Run this code
#include <chrono>
#include <iostream>
 
int main()
{
    const auto some_zone_name{"Australia/Sydney"};
    const auto time_pt_utc{std::chrono::system_clock::now()};
    std::cout << "Current time UTC is:\t\t " << time_pt_utc << '\n';
 
    try
    {
        std::cout << "Current time local is:\t\t "
                  << std::chrono::current_zone()-> // may throw
                      to_local(time_pt_utc) << '\n'
                  << "Current time " << some_zone_name << " is:\t "
                  << std::chrono::locate_zone(some_zone_name)-> // may throw
                      to_local(time_pt_utc) << '\n';
    }
    catch(const std::runtime_error& ex)
    {
        std::cout << ex.what() << '\n';
    }
}

Possible output: 

Current time UTC is:              2025-02-10 13:38:13.233872158
Current time local is:            2025-02-10 16:38:13.233872158
Current time Australia/Sydney is: 2025-02-11 00:38:13.233872158
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/chrono/time_zone/to_local&oldid=180427"