Difference between revisions of "cpp/chrono/file clock/to from utc"
From cppreference.com
< cpp | chrono | file clock
m (→See also) |
m (fmt) |
||
| Line 2: | Line 2: | ||
{{cpp/chrono/file_clock/navbar}} | {{cpp/chrono/file_clock/navbar}} | ||
{{dcl begin}} | {{dcl begin}} | ||
| − | {{dcl|num=1|since=c++20|notes={{mark optional}} |1= | + | {{dcl|num=1|since=c++20|notes={{mark optional}}|1= |
template< class Duration > | template< class Duration > | ||
| − | static std::chrono::utc_time</*see below*/> | + | static std::chrono::utc_time</* see below */> |
to_utc( const std::chrono::file_time<Duration>& t ); | to_utc( const std::chrono::file_time<Duration>& t ); | ||
}} | }} | ||
| − | {{dcl|num=2|since=c++20|notes={{mark optional}} |1= | + | {{dcl|num=2|since=c++20|notes={{mark optional}}|1= |
| − | template < class Duration > | + | template< class Duration > |
| − | static std::chrono::file_time</*see below*/> | + | static std::chrono::file_time</* see below */> |
from_utc( const std::chrono::utc_time<Duration>& t ); | from_utc( const std::chrono::utc_time<Duration>& t ); | ||
}} | }} | ||
{{dcl end}} | {{dcl end}} | ||
| − | @1@ Converts the {{tt|file_time}} {{ | + | @1@ Converts the {{tt|file_time}} {{c|t}} to a {{tt|utc_time}} representing the same point in time. |
| − | @2@ Converts the {{tt|utc_time}} {{ | + | @2@ Converts the {{tt|utc_time}} {{c|t}} to a {{tt|file_time}} representing the same point in time. |
The duration of the return type is computed from {{tt|Duration}} in an unspecified manner. | The duration of the return type is computed from {{tt|Duration}} in an unspecified manner. | ||
| Line 21: | Line 21: | ||
These function templates are optional: an implementation may choose to instead provide {{tt|to_sys}} and {{tt|from_sys}}. | These function templates are optional: an implementation may choose to instead provide {{tt|to_sys}} and {{tt|from_sys}}. | ||
| − | === Return value === | + | ===Return value=== |
@1@ A {{tt|utc_time}} representing the same point in time as the argument. | @1@ A {{tt|utc_time}} representing the same point in time as the argument. | ||
@2@ A {{tt|file_time}} representing the same point in time as the argument. | @2@ A {{tt|file_time}} representing the same point in time as the argument. | ||
| − | === Notes === | + | ===Notes=== |
User code should usually use {{lc|std::chrono::clock_cast}}, which provides a generic interface to convert time points between clocks, rather than call these functions directly. | User code should usually use {{lc|std::chrono::clock_cast}}, which provides a generic interface to convert time points between clocks, rather than call these functions directly. | ||
| − | === Example === | + | ===Example=== |
{{example}} | {{example}} | ||
| − | === See also === | + | ===See also=== |
{{dsc begin}} | {{dsc begin}} | ||
| − | {{dsc inc |cpp/chrono/file clock/dsc to from sys}} | + | {{dsc inc|cpp/chrono/file clock/dsc to from sys}} |
| − | {{dsc inc |cpp/chrono/dsc clock_cast}} | + | {{dsc inc|cpp/chrono/dsc clock_cast}} |
{{dsc end}} | {{dsc end}} | ||
{{langlinks|es|ja|ru|zh}} | {{langlinks|es|ja|ru|zh}} | ||
Revision as of 08:36, 26 December 2022
| template< class Duration > static std::chrono::utc_time</* see below */> |
(1) | (since C++20) (optional) |
| template< class Duration > static std::chrono::file_time</* see below */> |
(2) | (since C++20) (optional) |
1) Converts the
file_time t to a utc_time representing the same point in time.2) Converts the
utc_time t to a file_time representing the same point in time.The duration of the return type is computed from Duration in an unspecified manner.
These function templates are optional: an implementation may choose to instead provide to_sys and from_sys.
Contents |
Return value
1) A
utc_time representing the same point in time as the argument.2) A
file_time representing the same point in time as the argument.Notes
User code should usually use std::chrono::clock_cast, which provides a generic interface to convert time points between clocks, rather than call these functions directly.
Example
| This section is incomplete Reason: no example |
See also
| [static] (optional) |
converts between file_time and sys_time (public static member function) |
| (C++20) |
convert time points of one clock to another (function template) |
