Crate time[−][src]
Expand description
Feature flags
This crate exposes a number of features. These can be enabled or disabled as shown in Cargo’s documentation. Features are disabled by default unless otherwise noted.
Reliance on a given feature is always indicated alongside the item definition.
-
std
(enabled by default, implicitly enablesalloc
)This enables a number of features that depend on the standard library.
Instant
is the primary item that requires this feature, though some others methods may rely onInstant
internally. -
alloc
(enabled by default viastd
)Enables a number of features that require the ability to dynamically allocate memory.
-
macros
Enables macros that provide compile-time verification of values and intuitive syntax.
-
formatting
(implicitly enablesstd
)Enables formatting of most structs.
-
parsing
Enables parsing of most structs.
-
local-offset
(implicitly enablesstd
)This feature enables a number of methods that allow obtaining the system’s UTC offset.
-
large-dates
By default, only years within the ±9999 range (inclusive) are supported. If you need support for years outside this range, consider enabling this feature; the supported range will be increased to ±999,999.
Note that enabling this feature has some costs, as it means forgoing some optimizations. Ambiguities may be introduced when parsing that would not otherwise exist.
If you are using this feature, please leave a comment on this discussion with your use case. If there is not sufficient demand for this feature, it will be dropped in a future release.
-
serde
Enables serde support for all types.
-
serde-human-readable
(implicitly enablesserde
,formatting
, andparsing
)Allows serde representations to use a human-readable format. This is determined by the serializer, not the user. If this feature is not enabled or if the serializer requests a non-human-readable format, a format optimized for binary representation will be used.
-
rand
Enables rand support for all types.
-
quickcheck
(implicitly enablesalloc
)Enables quickcheck support for all types except
Instant
.
One pseudo-feature flag that is only available to end users is the unsound_local_offset
cfg.
As the name indicates, using the feature is unsound, and may cause unexpected segmentation
faults. Unlike other flags, this is deliberately
only available to end users; this is to ensure that a user doesn’t have unsound behavior without
knowing it. To enable this behavior, you must use RUSTFLAGS="--cfg unsound_local_offset" cargo build
or similar. Note: This flag is not tested anywhere, including in the regular test of
the powerset of all feature flags. Use at your own risk.
Re-exports
pub use crate::error::Error; |
Modules
error | Various error types returned by methods in the time crate. |
ext | Extension traits. |
format_description | formatting or parsing Description of how types should be formatted and parsed. |
formatting | formatting Formatting for various types. |
macros | macros Macros to construct statically known values. |
parsing | parsing Parsing for various types. |
serde | serde Differential formats for serde. |
util | Utility functions. |
Structs
Date | Date in the proleptic Gregorian calendar. |
Duration | A span of time with nanosecond precision. |
Instant | std A measurement of a monotonically non-decreasing clock. Opaque and useful only with |
OffsetDateTime | A |
PrimitiveDateTime | Combined date and time. |
Time | The clock time within a given date. Nanosecond precision. |
UtcOffset | An offset from UTC. |
Enums
Month | Months of the year. |
Weekday | Days of the week. |
Type Definitions
Result | An alias for |