Struct core.time.FracSec
Everything in druntime and Phobos that was using FracSec now uses Duration for greater simplicity. So, FracSec has been deprecated. It will be removed from the docs in October 2018, and removed completely from druntime in October 2019.
struct FracSec
;
Represents fractional seconds.
This is the portion of the time which is smaller than a second and it cannot hold values which would be greater than or equal to a second (or less than or equal to a negative second).
It holds hnsecs internally, but you can create it using either milliseconds,
microseconds, or hnsecs. What it does is allow for a simple way to set or
adjust the fractional seconds portion of a Duration
or a
std
without having to worry about whether you're
dealing with milliseconds, microseconds, or hnsecs.
FracSec
's functions which take time unit strings do accept
"nsecs"
, but because the resolution of Duration
and
std
is hnsecs, you don't actually get precision higher
than hnsecs. "nsecs"
is accepted merely for convenience. Any values
given as nsecs will be converted to hnsecs using convert
(which uses
truncating division when converting to smaller units).
Properties
Name | Type | Description |
---|---|---|
hnsecs [get]
|
int | The value of this FracSec as hnsecs.
|
hnsecs [set]
|
int | The value of this FracSec as hnsecs.
|
msecs [get]
|
int | The value of this FracSec as milliseconds.
|
msecs [set]
|
int | The value of this FracSec as milliseconds.
|
nsecs [get]
|
int | The value of this FracSec as nsecs.
|
nsecs [set]
|
long | The value of this FracSec as nsecs.
|
usecs [get]
|
int | The value of this FracSec as microseconds.
|
usecs [set]
|
int | The value of this FracSec as microseconds.
|
zero [get]
|
FracSec | A FracSec of 0 . It's shorter than doing something like
FracSec and more explicit than FracSec .
|
Methods
Name | Description |
---|---|
from
|
Create a FracSec from the given units ("msecs" , "usecs" ,
or "hnsecs" ).
|
opUnary
|
Returns the negation of this FracSec .
|
toString
|
Converts this TickDuration to a string.
|
Authors
Jonathan M Davis and Kato Shoichi