V8 Project
v8::Date Class Reference

An instance of the built-in Date constructor (ECMA-262, 15.9). More...

#include <v8.h>

+ Inheritance diagram for v8::Date:
+ Collaboration diagram for v8::Date:

Public Member Functions

double ValueOf () const
 A specialization of Value::NumberValue that is more efficient because we know the structure of this object. More...
 
- Public Member Functions inherited from v8::Object
bool Set (Handle< Value > key, Handle< Value > value)
 
bool Set (uint32_t index, Handle< Value > value)
 
bool ForceSet (Handle< Value > key, Handle< Value > value, PropertyAttribute attribs=None)
 
Local< ValueGet (Handle< Value > key)
 
Local< ValueGet (uint32_t index)
 
PropertyAttribute GetPropertyAttributes (Handle< Value > key)
 Gets the property attributes of a property which can be None or any combination of ReadOnly, DontEnum and DontDelete. More...
 
Local< ValueGetOwnPropertyDescriptor (Local< String > key)
 Returns Object.getOwnPropertyDescriptor as per ES5 section 15.2.3.3. More...
 
bool Has (Handle< Value > key)
 
bool Delete (Handle< Value > key)
 
bool ForceDelete (Handle< Value > key)
 
bool Has (uint32_t index)
 
bool Delete (uint32_t index)
 
bool SetAccessor (Handle< String > name, AccessorGetterCallback getter, AccessorSetterCallback setter=0, Handle< Value > data=Handle< Value >(), AccessControl settings=DEFAULT, PropertyAttribute attribute=None)
 
bool SetAccessor (Handle< Name > name, AccessorNameGetterCallback getter, AccessorNameSetterCallback setter=0, Handle< Value > data=Handle< Value >(), AccessControl settings=DEFAULT, PropertyAttribute attribute=None)
 
bool SetDeclaredAccessor (Local< Name > name, Local< DeclaredAccessorDescriptor > descriptor, PropertyAttribute attribute=None, AccessControl settings=DEFAULT)
 
void SetAccessorProperty (Local< Name > name, Local< Function > getter, Handle< Function > setter=Handle< Function >(), PropertyAttribute attribute=None, AccessControl settings=DEFAULT)
 
bool HasPrivate (Handle< Private > key)
 Functionality for private properties. More...
 
bool SetPrivate (Handle< Private > key, Handle< Value > value)
 
bool DeletePrivate (Handle< Private > key)
 
Local< ValueGetPrivate (Handle< Private > key)
 
Local< ArrayGetPropertyNames ()
 Returns an array containing the names of the enumerable properties of this object, including properties from prototype objects. More...
 
Local< ArrayGetOwnPropertyNames ()
 This function has the same functionality as GetPropertyNames but the returned array doesn't contain the names of properties from prototype objects. More...
 
Local< ValueGetPrototype ()
 Get the prototype object. More...
 
bool SetPrototype (Handle< Value > prototype)
 Set the prototype object. More...
 
Local< ObjectFindInstanceInPrototypeChain (Handle< FunctionTemplate > tmpl)
 Finds an instance of the given function template in the prototype chain. More...
 
Local< StringObjectProtoToString ()
 Call builtin Object.prototype.toString on this object. More...
 
Local< StringGetConstructorName ()
 Returns the name of the function invoked as a constructor for this object. More...
 
int InternalFieldCount ()
 Gets the number of internal fields for this Object. More...
 
Local< ValueGetInternalField (int index)
 Gets the value from an internal field. More...
 
void SetInternalField (int index, Handle< Value > value)
 Sets the value in an internal field. More...
 
void * GetAlignedPointerFromInternalField (int index)
 Gets a 2-byte-aligned native pointer from an internal field. More...
 
void SetAlignedPointerInInternalField (int index, void *value)
 Sets a 2-byte-aligned native pointer in an internal field. More...
 
bool HasOwnProperty (Handle< String > key)
 
bool HasRealNamedProperty (Handle< String > key)
 
bool HasRealIndexedProperty (uint32_t index)
 
bool HasRealNamedCallbackProperty (Handle< String > key)
 
Local< ValueGetRealNamedPropertyInPrototypeChain (Handle< String > key)
 If result.IsEmpty() no real property was located in the prototype chain. More...
 
Local< ValueGetRealNamedProperty (Handle< String > key)
 If result.IsEmpty() no real property was located on the object or in the prototype chain. More...
 
bool HasNamedLookupInterceptor ()
 Tests for a named lookup interceptor. More...
 
bool HasIndexedLookupInterceptor ()
 Tests for an index lookup interceptor. More...
 
void TurnOnAccessCheck ()
 Turns on access check on the object if the object is an instance of a template that has access check callbacks. More...
 
int GetIdentityHash ()
 Returns the identity hash for this object. More...
 
bool SetHiddenValue (Handle< String > key, Handle< Value > value)
 Access hidden properties on JavaScript objects. More...
 
Local< ValueGetHiddenValue (Handle< String > key)
 
bool DeleteHiddenValue (Handle< String > key)
 
bool IsDirty ()
 Returns true if this is an instance of an api function (one created from a function created from a function template) and has been modified since it was created. More...
 
Local< ObjectClone ()
 Clone this object with a fast but shallow copy. More...
 
Local< ContextCreationContext ()
 Returns the context in which the object was created. More...
 
void SetIndexedPropertiesToPixelData (uint8_t *data, int length)
 Set the backing store of the indexed properties to be managed by the embedding layer. More...
 
bool HasIndexedPropertiesInPixelData ()
 
uint8_t * GetIndexedPropertiesPixelData ()
 
int GetIndexedPropertiesPixelDataLength ()
 
void SetIndexedPropertiesToExternalArrayData (void *data, ExternalArrayType array_type, int number_of_elements)
 Set the backing store of the indexed properties to be managed by the embedding layer. More...
 
bool HasIndexedPropertiesInExternalArrayData ()
 
void * GetIndexedPropertiesExternalArrayData ()
 
ExternalArrayType GetIndexedPropertiesExternalArrayDataType ()
 
int GetIndexedPropertiesExternalArrayDataLength ()
 
bool IsCallable ()
 Checks whether a callback is set by the ObjectTemplate::SetCallAsFunctionHandler method. More...
 
Local< ValueCallAsFunction (Handle< Value > recv, int argc, Handle< Value > argv[])
 Call an Object as a function if a callback is set by the ObjectTemplate::SetCallAsFunctionHandler method. More...
 
Local< ValueCallAsConstructor (int argc, Handle< Value > argv[])
 Call an Object as a constructor if a callback is set by the ObjectTemplate::SetCallAsFunctionHandler method. More...
 
- Public Member Functions inherited from v8::Value
bool IsUndefined () const
 Returns true if this value is the undefined value. More...
 
bool IsNull () const
 Returns true if this value is the null value. More...
 
bool IsTrue () const
 Returns true if this value is true. More...
 
bool IsFalse () const
 Returns true if this value is false. More...
 
bool IsName () const
 Returns true if this value is a symbol or a string. More...
 
bool IsString () const
 Returns true if this value is an instance of the String type. More...
 
bool IsSymbol () const
 Returns true if this value is a symbol. More...
 
bool IsFunction () const
 Returns true if this value is a function. More...
 
bool IsArray () const
 Returns true if this value is an array. More...
 
bool IsObject () const
 Returns true if this value is an object. More...
 
bool IsBoolean () const
 Returns true if this value is boolean. More...
 
bool IsNumber () const
 Returns true if this value is a number. More...
 
bool IsExternal () const
 Returns true if this value is external. More...
 
bool IsInt32 () const
 Returns true if this value is a 32-bit signed integer. More...
 
bool IsUint32 () const
 Returns true if this value is a 32-bit unsigned integer. More...
 
bool IsDate () const
 Returns true if this value is a Date. More...
 
bool IsArgumentsObject () const
 Returns true if this value is an Arguments object. More...
 
bool IsBooleanObject () const
 Returns true if this value is a Boolean object. More...
 
bool IsNumberObject () const
 Returns true if this value is a Number object. More...
 
bool IsStringObject () const
 Returns true if this value is a String object. More...
 
bool IsSymbolObject () const
 Returns true if this value is a Symbol object. More...
 
bool IsNativeError () const
 Returns true if this value is a NativeError. More...
 
bool IsRegExp () const
 Returns true if this value is a RegExp. More...
 
bool IsGeneratorFunction () const
 Returns true if this value is a Generator function. More...
 
bool IsGeneratorObject () const
 Returns true if this value is a Generator object (iterator). More...
 
bool IsPromise () const
 Returns true if this value is a Promise. More...
 
bool IsMap () const
 Returns true if this value is a Map. More...
 
bool IsSet () const
 Returns true if this value is a Set. More...
 
bool IsWeakMap () const
 Returns true if this value is a WeakMap. More...
 
bool IsWeakSet () const
 Returns true if this value is a WeakSet. More...
 
bool IsArrayBuffer () const
 Returns true if this value is an ArrayBuffer. More...
 
bool IsArrayBufferView () const
 Returns true if this value is an ArrayBufferView. More...
 
bool IsTypedArray () const
 Returns true if this value is one of TypedArrays. More...
 
bool IsUint8Array () const
 Returns true if this value is an Uint8Array. More...
 
bool IsUint8ClampedArray () const
 Returns true if this value is an Uint8ClampedArray. More...
 
bool IsInt8Array () const
 Returns true if this value is an Int8Array. More...
 
bool IsUint16Array () const
 Returns true if this value is an Uint16Array. More...
 
bool IsInt16Array () const
 Returns true if this value is an Int16Array. More...
 
bool IsUint32Array () const
 Returns true if this value is an Uint32Array. More...
 
bool IsInt32Array () const
 Returns true if this value is an Int32Array. More...
 
bool IsFloat32Array () const
 Returns true if this value is a Float32Array. More...
 
bool IsFloat64Array () const
 Returns true if this value is a Float64Array. More...
 
bool IsDataView () const
 Returns true if this value is a DataView. More...
 
Local< BooleanToBoolean () const
 
Local< NumberToNumber () const
 
Local< StringToString () const
 
Local< StringToDetailString () const
 
Local< ObjectToObject () const
 
Local< IntegerToInteger () const
 
Local< Uint32ToUint32 () const
 
Local< Int32ToInt32 () const
 
Local< Uint32ToArrayIndex () const
 Attempts to convert a string to an array index. More...
 
bool BooleanValue () const
 
double NumberValue () const
 
int64_t IntegerValue () const
 
uint32_t Uint32Value () const
 
int32_t Int32Value () const
 
bool Equals (Handle< Value > that) const
 JS ==. More...
 
bool StrictEquals (Handle< Value > that) const
 
bool SameValue (Handle< Value > that) const
 

Static Public Member Functions

static Local< ValueNew (Isolate *isolate, double time)
 
static DateCast (v8::Value *obj)
 
static void DateTimeConfigurationChangeNotification (Isolate *isolate)
 Notification that the embedder has changed the time zone, daylight savings time, or other date / time configuration parameters. More...
 
- Static Public Member Functions inherited from v8::Object
static int InternalFieldCount (const PersistentBase< Object > &object)
 Same as above, but works for Persistents. More...
 
static void * GetAlignedPointerFromInternalField (const PersistentBase< Object > &object, int index)
 Same as above, but works for Persistents. More...
 
static Local< ObjectNew (Isolate *isolate)
 
static ObjectCast (Value *obj)
 
- Static Public Member Functions inherited from v8::Value
template<class T >
static ValueCast (T *value)
 

Static Private Member Functions

static void CheckCast (v8::Value *obj)
 

Detailed Description

An instance of the built-in Date constructor (ECMA-262, 15.9).

Definition at line 3184 of file v8.h.

Member Function Documentation

◆ Cast()

Date * v8::Date::Cast ( v8::Value obj)
inlinestatic

Definition at line 6606 of file v8.h.

6606  {
6607 #ifdef V8_ENABLE_CHECKS
6608  CheckCast(value);
6609 #endif
6610  return static_cast<Date*>(value);
6611 }
static void CheckCast(v8::Value *obj)
Definition: api.cc:2832

◆ CheckCast()

void v8::Date::CheckCast ( v8::Value obj)
staticprivate

Definition at line 2832 of file api.cc.

2832  {
2834  i::Isolate* isolate = NULL;
2835  if (obj->IsHeapObject()) isolate = i::HeapObject::cast(*obj)->GetIsolate();
2836  Utils::ApiCheck(isolate != NULL &&
2837  obj->HasSpecificClassOf(isolate->heap()->Date_string()),
2838  "v8::Date::Cast()",
2839  "Could not convert to date");
2840 }
static bool ApiCheck(bool condition, const char *location, const char *message)
Definition: api.h:177
static v8::internal::Handle< To > OpenHandle(v8::Local< From > handle)
Definition: api.h:288
enable harmony numeric enable harmony object literal extensions Optimize object Array DOM strings and string trace pretenuring decisions of HAllocate instructions Enables optimizations which favor memory size over execution speed maximum source size in bytes considered for a single inlining maximum cumulative number of AST nodes considered for inlining trace the tracking of allocation sites deoptimize every n garbage collections perform array bounds checks elimination analyze liveness of environment slots and zap dead values flushes the cache of optimized code for closures on every GC allow uint32 values on optimize frames if they are used only in safe operations track concurrent recompilation artificial compilation delay in ms do not emit check maps for constant values that have a leaf deoptimize the optimized code if the layout of the maps changes enable context specialization in TurboFan execution budget before interrupt is triggered max percentage of megamorphic generic ICs to allow optimization enable use of SAHF instruction if enable use of VFP3 instructions if available enable use of NEON instructions if enable use of SDIV and UDIV instructions if enable use of MLS instructions if enable loading bit constant by means of movw movt instruction enable unaligned accesses for enable use of d16 d31 registers on ARM this requires VFP3 force all emitted branches to be in long enable alignment of csp to bytes on platforms which prefer the register to always be NULL

References v8::Utils::ApiCheck(), v8::internal::Isolate::heap(), NULL, and v8::Utils::OpenHandle().

+ Here is the call graph for this function:

◆ DateTimeConfigurationChangeNotification()

void v8::Date::DateTimeConfigurationChangeNotification ( Isolate isolate)
static

Notification that the embedder has changed the time zone, daylight savings time, or other date / time configuration parameters.

V8 keeps a cache of various values used for date / time computation. This notification will reset those cached values for the current context so that date / time configuration changes would be reflected in the Date object.

This API should not be called more than needed as it will negatively impact the performance of date operations.

Definition at line 5730 of file api.cc.

5730  {
5731  i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate);
5732  if (!i_isolate->IsInitialized()) return;
5733  ON_BAILOUT(i_isolate, "v8::Date::DateTimeConfigurationChangeNotification()",
5734  return);
5735  LOG_API(i_isolate, "Date::DateTimeConfigurationChangeNotification");
5736  ENTER_V8(i_isolate);
5737 
5738  i_isolate->date_cache()->ResetDateCache();
5739 
5740  if (!i_isolate->eternal_handles()->Exists(
5742  return;
5743  }
5744  i::Handle<i::FixedArray> date_cache_version =
5747  DCHECK_EQ(1, date_cache_version->length());
5748  CHECK(date_cache_version->get(0)->IsSmi());
5749  date_cache_version->set(
5750  0,
5751  i::Smi::FromInt(i::Smi::cast(date_cache_version->get(0))->value() + 1));
5752 }
#define ON_BAILOUT(isolate, location, code)
Definition: api.cc:60
#define LOG_API(isolate, expr)
Definition: api.cc:52
#define ENTER_V8(isolate)
Definition: api.cc:54
void ResetDateCache()
Definition: date.cc:27
bool Exists(SingletonHandle singleton)
Handle< Object > GetSingleton(SingletonHandle singleton)
static Handle< T > cast(Handle< S > that)
Definition: handles.h:116
DateCache * date_cache()
Definition: isolate.h:1020
EternalHandles * eternal_handles()
Definition: isolate.h:919
static Smi * FromInt(int value)
Definition: objects-inl.h:1321
#define CHECK(condition)
Definition: logging.h:36
#define DCHECK_EQ(v1, v2)
Definition: logging.h:206

References v8::internal::Handle< T >::cast(), CHECK, v8::internal::Isolate::date_cache(), v8::internal::EternalHandles::DATE_CACHE_VERSION, DCHECK_EQ, ENTER_V8, v8::internal::Isolate::eternal_handles(), v8::internal::EternalHandles::Exists(), v8::internal::Smi::FromInt(), v8::internal::EternalHandles::GetSingleton(), v8::internal::Isolate::IsInitialized(), LOG_API, ON_BAILOUT, and v8::internal::DateCache::ResetDateCache().

+ Here is the call graph for this function:

◆ New()

Local< v8::Value > v8::Date::New ( Isolate isolate,
double  time 
)
static

Definition at line 5704 of file api.cc.

5704  {
5705  i::Isolate* i_isolate = reinterpret_cast<i::Isolate*>(isolate);
5706  LOG_API(i_isolate, "Date::New");
5707  if (std::isnan(time)) {
5708  // Introduce only canonical NaN value into the VM, to avoid signaling NaNs.
5709  time = base::OS::nan_value();
5710  }
5711  ENTER_V8(i_isolate);
5712  EXCEPTION_PREAMBLE(i_isolate);
5714  has_pending_exception = !i::Execution::NewDate(
5715  i_isolate, time).ToHandle(&obj);
5716  EXCEPTION_BAILOUT_CHECK(i_isolate, Local<v8::Value>());
5717  return Utils::ToLocal(obj);
5718 }
#define EXCEPTION_BAILOUT_CHECK(isolate, value)
Definition: api.cc:93
#define EXCEPTION_PREAMBLE(isolate)
Definition: api.cc:67
static Local< Context > ToLocal(v8::internal::Handle< v8::internal::Context > obj)
static double nan_value()

References ENTER_V8, EXCEPTION_BAILOUT_CHECK, EXCEPTION_PREAMBLE, LOG_API, v8::base::OS::nan_value(), and v8::Utils::ToLocal().

+ Here is the call graph for this function:

◆ ValueOf()

double v8::Date::ValueOf ( ) const

A specialization of Value::NumberValue that is more efficient because we know the structure of this object.

Definition at line 5721 of file api.cc.

5721  {
5724  i::Isolate* isolate = jsdate->GetIsolate();
5725  LOG_API(isolate, "Date::NumberValue");
5726  return jsdate->value()->Number();
5727 }

References v8::internal::Handle< T >::cast(), LOG_API, and v8::Utils::OpenHandle().

+ Here is the call graph for this function:

The documentation for this class was generated from the following files: