NAME

       BSON::Time - BSON type wrapper for date and time

VERSION

       version v1.4.0

SYNOPSIS

           use BSON::Types ':all';

           bson_time( $number );

DESCRIPTION

       This module provides a BSON type wrapper for a 64-bit date-time value in the form of milliseconds since
       the Unix epoch (UTC only).

       On a Perl without 64-bit integer support, the value must be a Math::BigInt object.

ATTRIBUTES

   value
       A integer representing milliseconds since the Unix epoch.  The default is 0.

METHODS

   epoch
       Returns the number of seconds since the epoch (i.e. a floating-point value).

   as_iso8601
       Returns the "value" as an ISO-8601 formatted string of the form "YYYY-MM-DDThh:mm:ss.sssZ".  The
       fractional seconds will be omitted if they are zero.

   as_datetime
       Loads DateTime and returns the "value" as a DateTime object.

   as_datetime_tiny
       Loads DateTime::Tiny and returns the "value" as a DateTime::Tiny object.

   as_mango_time
       Loads Mango::BSON::Time and returns the "value" as a Mango::BSON::Time object.

   as_time_moment
       Loads Time::Moment and returns the "value" as a Time::Moment object.

   TO_JSON
       Returns a string formatted by "as_iso8601".

       If the "BSON_EXTJSON" option is true, it will instead be compatible with MongoDB's extended JSON
       <https://docs.mongodb.org/manual/reference/mongodb-extended-json/> format, which represents it as a
       document as follows:

           {"$date" : { "$numberLong": "22337203685477580" } }

OVERLOADING

       Both numification ("0+") and stringification ("") are overloaded to return the result of "epoch".
       Numeric comparison and string comparison are overloaded based on those and fallback overloading is
       enabled.

AUTHORS

       •   David Golden <david@mongodb.com>

       •   Stefan G. <minimalist@lavabit.com>

COPYRIGHT AND LICENSE

       This software is Copyright (c) 2017 by Stefan G. and MongoDB, Inc.

       This is free software, licensed under:

         The Apache License, Version 2.0, January 2004

perl v5.26.0                                       2017-09-06                                    BSON::Time(3pm)