NAME

       BSON::Timestamp - BSON type wrapper for timestamps

VERSION

       version v1.4.0

SYNOPSIS

           use BSON::Types ':all';

           bson_timestamp( $seconds );
           bson_timestamp( $seconds, $increment );

DESCRIPTION

       This module provides a BSON type wrapper for a BSON timestamp value.

       Generally, it should not be used by end-users, but is provided for backwards
       compatibility.

ATTRIBUTES

   seconds
       A value representing seconds since the Unix epoch.  The default is current value of
       "time()".

   increment
       A numeric value to disambiguate timestamps in the same second.  The default is 0.

METHODS

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

           {"$timestamp" : { "t":<seconds>, "i":<increment> }}

       If the "BSON_EXTJSON" option is false, an error is thrown, as this value can't otherwise
       be represented in JSON.

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