18c339a94Sopenharmony_ci# Date
28c339a94Sopenharmony_ci
38c339a94Sopenharmony_ci`Napi::Date` class is a representation of the JavaScript `Date` object. The
48c339a94Sopenharmony_ci`Napi::Date` class inherits its behavior from the `Napi::Value` class
58c339a94Sopenharmony_ci(for more info see [`Napi::Value`](value.md)).
68c339a94Sopenharmony_ci
78c339a94Sopenharmony_ci## Methods
88c339a94Sopenharmony_ci
98c339a94Sopenharmony_ci### Constructor
108c339a94Sopenharmony_ci
118c339a94Sopenharmony_ciCreates a new _empty_ instance of a `Napi::Date` object.
128c339a94Sopenharmony_ci
138c339a94Sopenharmony_ci```cpp
148c339a94Sopenharmony_ciNapi::Date::Date();
158c339a94Sopenharmony_ci```
168c339a94Sopenharmony_ci
178c339a94Sopenharmony_ciCreates a new _non-empty_ instance of a `Napi::Date` object.
188c339a94Sopenharmony_ci
198c339a94Sopenharmony_ci```cpp
208c339a94Sopenharmony_ciNapi::Date::Date(napi_env env, napi_value value);
218c339a94Sopenharmony_ci```
228c339a94Sopenharmony_ci
238c339a94Sopenharmony_ci - `[in] env`: The environment in which to construct the `Napi::Date` object.
248c339a94Sopenharmony_ci - `[in] value`: The `napi_value` which is a handle for a JavaScript `Date`.
258c339a94Sopenharmony_ci
268c339a94Sopenharmony_ci### New
278c339a94Sopenharmony_ci
288c339a94Sopenharmony_ciCreates a new instance of a `Napi::Date` object.
298c339a94Sopenharmony_ci
308c339a94Sopenharmony_ci```cpp
318c339a94Sopenharmony_cistatic Napi::Date Napi::Date::New(Napi::Env env, double value);
328c339a94Sopenharmony_ci```
338c339a94Sopenharmony_ci
348c339a94Sopenharmony_ci - `[in] env`: The environment in which to construct the `Napi::Date` object.
358c339a94Sopenharmony_ci - `[in] value`: The time value the JavaScript `Date` will contain represented
368c339a94Sopenharmony_ci  as the number of milliseconds since 1 January 1970 00:00:00 UTC.
378c339a94Sopenharmony_ci
388c339a94Sopenharmony_ciReturns a new instance of `Napi::Date` object.
398c339a94Sopenharmony_ci
408c339a94Sopenharmony_ci### ValueOf
418c339a94Sopenharmony_ci
428c339a94Sopenharmony_ci```cpp
438c339a94Sopenharmony_cidouble Napi::Date::ValueOf() const;
448c339a94Sopenharmony_ci```
458c339a94Sopenharmony_ci
468c339a94Sopenharmony_ciReturns the time value as `double` primitive represented as the number of
478c339a94Sopenharmony_ci milliseconds since 1 January 1970 00:00:00 UTC.
488c339a94Sopenharmony_ci
498c339a94Sopenharmony_ci## Operators
508c339a94Sopenharmony_ci
518c339a94Sopenharmony_ci### operator double
528c339a94Sopenharmony_ci
538c339a94Sopenharmony_ciConverts a `Napi::Date` value to a `double` primitive.
548c339a94Sopenharmony_ci
558c339a94Sopenharmony_ci```cpp
568c339a94Sopenharmony_ciNapi::Date::operator double() const;
578c339a94Sopenharmony_ci```
588c339a94Sopenharmony_ci
598c339a94Sopenharmony_ci### Example
608c339a94Sopenharmony_ci
618c339a94Sopenharmony_ciThe following shows an example of casting a `Napi::Date` value to a `double`
628c339a94Sopenharmony_ci primitive.
638c339a94Sopenharmony_ci
648c339a94Sopenharmony_ci```cpp
658c339a94Sopenharmony_cidouble operatorVal = Napi::Date::New(Env(), 0); // Napi::Date to double
668c339a94Sopenharmony_ci// or
678c339a94Sopenharmony_ciauto instanceVal = info[0].As<Napi::Date>().ValueOf();
688c339a94Sopenharmony_ci```
69