perldoc > BSON::Timestamp

man perldoc info pydoc3 ri search

📛 NAME

BSON::Timestamp - BSON type wrapper for timestamps

🚀 Quick Reference

Use Case	Command	Description
Create timestamp from current epoch seconds	bson_timestamp( $seconds )	Wraps seconds since Unix epoch with default increment 0
Create timestamp with explicit increment	bson_timestamp( $seconds, $increment )	Adds an increment to disambiguate same‑second timestamps
Import BSON timestamp constructor	use BSON::Types ':all';	Import bson_timestamp and other BSON type constructors
Get current timestamp	bson_timestamp()	Defaults seconds to time() and increment to 0
Convert to extended JSON	$ts->TO_JSON	Returns hashref compatible with BSON_EXTJSON option

ℹ️ VERSION

version v1.12.2

📋 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 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 AT mongodb.com>
• Stefan G. <minimalist AT lavabit.com>

©️ COPYRIGHT AND LICENSE

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

This is free software, licensed under:

The Apache License, Version 2.0, January 2004

📛 NAME 🚀 Quick Reference ℹ️ VERSION 📋 SYNOPSIS 📖 DESCRIPTION 🔧 ATTRIBUTES 📚 METHODS 👥 AUTHORS ©️ COPYRIGHT AND LICENSE