Skip to main content

Dealing with dates and times should be easy

Project description


[![Build Status][travis]](


A Python library for dealing with dates/times. Inspired by both
[**Moment.js**][moment] and the simplicity of Kenneth Reitz's
[**Requests**][requests] library. Ideas were also taken from the
[**Times**][times] Python module.



This is extremely alpha software right now. Eventually you'll be able to install
it with:

`pip install moment`


import moment
from datetime import datetime

# Create a moment from a string"12-18-2012", "M-D-YYYY")

# Create a moment with strftime format"12-18-2012", "%m-%d-%Y")

# Create a moment from the current datetime

# The moment can also be UTC-based

# Create a moment with the UTC time zone
moment.utc("2012-12-18", "YYYY-M-D")

# Create a moment from a Unix timestamp

# Create a moment from a Unix UTC timestamp
moment.unix(1355875153626, utc=True)

# Return a datetime instance[2012, 12, 18]).to_date()

# Alternatively, use the done method to return a datetime, 12, 18)).done()

# And, who needs an iterable when we have star args?, 12, 18).done()

# Same thing with UTC datetimes
moment.utc(2012, 12, 18).to_date()

# Create and format a moment using Moment.js semantics'YYYY-M-D')

# Create and format a moment with strftime semantics, 12, 18)).strftime('%Y-%m-%d')

# Update your moment's time zone, 12, 18)).locale('US/Central').done()

# Alter the moment's UTC time zone to a different time zone

# Set and update your moment's time zone. For instance, I'm in SF
# but want NYC's current time.'US/Pacific').timezone('US/Eastern')

# In order to manipulate time zones, a locale must always be set or
# you must be using UTC.

# You can also clone a moment, so the original stays unaltered
now = moment.utcnow().timezone('US/Pacific')
future = now.clone().add(weeks=2)


Moment allows you to chain commands, which turns out to be super useful.

# Customize your moment by chaining commands[2012, 12, 18]).add(days=2).subtract(weeks=3).done()

# Imagine trying to do this with datetime, right?
moment.utcnow().add(years=3).add(months=2).format('YYYY-M-D h:m A')

# Both alternatively take keyword arguments, 12, 19).add(hours=1, minutes=2, seconds=3)

# And a similar subtract example[2012, 12, 19, 1, 2, 3]).subtract(hours=1, minutes=2, seconds=3)

# In addition to adding/subtracting, we can also replace values, minutes=15, seconds=0).epoch()

# And, if you'd prefer to keep the microseconds on your epoch value, minutes=15, seconds=0).epoch(rounding=False)

# Years, months, and days can also be set, months=1, days=1, hours=0, minutes=0, seconds=0)

# Also, datetime properties are available
moment.utc((2012, 12, 19)).year == 2012

# We can also manipulate to preferred weekdays, such as Monday, 12, 19)).replace(weekday=1).strftime('%Y-%m-%d')

# Or, this upcoming Sunday (with alternative syntax)'2012-12-19', 'YYYY-MM-DD').weekday(7).to_date()

# We can even go back to two Sundays ago[2012, 12, 19]).weekday(-7).format('YYYY-MM-DD')

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

moment-0.0.14.tar.gz (5.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page