---
title: "FilesystemDateStamp"
description: "API documentation for FilesystemDateStamp"
url: https://developer.disguise.one/python-api/docs/filesystemdatestamp/
---

# FilesystemDateStamp

Date and time stamp based on year zero epoch, with millisecond resolution

Notes:

-   Dates before 1/1/1970 will result in unixTime() = -1.
-   Dates before 1/1/1900 may result in invalid or inconsistent std::tm from timeDate().
-   Daylight Saving Time is observed in unixTime() and timeDate(), but not in the \*\_utc() variants.

See also: [Utility Guide](/plugins/guides/utility)

Base class: _\_BlipValue_

Subclasses: _[DateStamp](/python-api/docs/datestamp#datestamp)_

## Properties

#### **date** : _int_

#### **durationInSeconds** : _float_ _(Read-Only)_

#### **time** : _int_

## Constructors

#### **\_\_init\_\_**(self)

#### **\_\_init\_\_**(self, rhs: _[FilesystemDateStamp](/python-api/docs/filesystemdatestamp#filesystemdatestamp)_)

## Methods

#### **asPathString**(self) -> _str_

The current date stamp formatted such that it can be included safely in a file or folder name in Windows. e.g. 21\_oct\_2025\_14h35m59s780ms

**Returns** A string of the current formatted date stamp.

#### **asString**(self) -> _str_

#### **asTimeString**(self, showMsec: _bool_) -> _str_

## Static Methods

#### **localNow**() -> _[FilesystemDateStamp](/python-api/docs/filesystemdatestamp#filesystemdatestamp)_

#### **utcNow**() -> _[FilesystemDateStamp](/python-api/docs/filesystemdatestamp#filesystemdatestamp)_

## Special Methods

#### **\_\_add\_\_**(self, ds: _[FilesystemDateStamp](/python-api/docs/filesystemdatestamp#filesystemdatestamp)_) -> _[FilesystemDateStamp](/python-api/docs/filesystemdatestamp#filesystemdatestamp)_

#### **\_\_cmp\_\_**(self, o: _[FilesystemDateStamp](/python-api/docs/filesystemdatestamp#filesystemdatestamp)_) -> _int_

#### **\_\_eq\_\_**(self, ds: _[FilesystemDateStamp](/python-api/docs/filesystemdatestamp#filesystemdatestamp)_) -> _bool_

#### **\_\_ne\_\_**(self, ds: _[FilesystemDateStamp](/python-api/docs/filesystemdatestamp#filesystemdatestamp)_) -> _bool_

#### **\_\_sub\_\_**(self, ds: _[FilesystemDateStamp](/python-api/docs/filesystemdatestamp#filesystemdatestamp)_) -> _[FilesystemDateStamp](/python-api/docs/filesystemdatestamp#filesystemdatestamp)_