Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/chrono/file clock/to from utc"

From cppreference.com
< cpp‎ | chrono‎ | file clock
m (→‎See also)
m (fmt.)
 
(One intermediate revision by one user not shown)
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 tooltip|optional|provided only if to_sys and from_sys are not provided}}|
 
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 tooltip|optional|provided only if to_sys and from_sys are not provided}}|
−
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}} {{tt|t}} to a {{tt|utc_time}} representing the same point in 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}} {{tt|t}} to a {{tt|file_time}} representing the same point in 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.
  
−
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 {{rlpf|to from sys|to_sys}} and {{rlpf|to from sys|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 {{c/core|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}}

Latest revision as of 17:19, 1 November 2024

 
C++
 
Utilities library
General utilities
Relational operators (deprecated in C++20)
 
Date and time utilities
Time point
(C++11)
(C++20)
Duration
(C++11)
Clocks
(C++11)
(C++11)
(C++20)
(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)
Time zone
(C++20)
(C++20)
(C++20)(C++20)(C++20)(C++20)  
(C++20)
chrono I/O
(C++20)
C-style date and time
 
std::chrono::file_clock
Member functions

(optional*)

file_clock::to_utcfile_clock::from_utc
(optional*)
Time point I/O
 
template< class Duration >

static std::chrono::utc_time</* see below */>

    to_utc( const std::chrono::file_time<Duration>& t );
 (1) (since C++20)
(optional*)
template< class Duration >

static std::chrono::file_time</* see below */>

    from_utc( const std::chrono::utc_time<Duration>& t );
 (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

[edit] 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.

[edit] 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.

[edit] Example

This section is incomplete
Reason: no example

[edit] See also

[static] (optional)
 converts between file_time and sys_time
(public static member function) [edit]
(C++20)
 convert time points of one clock to another
(function template) [edit]
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/chrono/file_clock/to_from_utc&oldid=177462"