Moment

Common errors

• ModuleNotFoundError: No module named 'moment'

  cause The 'moment' library has not been installed in your current Python environment.
  fix Run `pip install moment` in your terminal to install the package.

• AttributeError: 'Moment' object has no attribute 'some_method_that_should_exist'

  cause This error often indicates that you are either calling a method that doesn't exist in the 'moment' library, or you are trying to use a method from `Moment.js` (JavaScript library) assuming it exists in the Python `moment` library, or that your 'moment' object has been mutated unexpectedly.
  fix Consult the `zachwill/moment` GitHub README for available methods. If expecting a non-mutated object, ensure you've used `.clone()` before modification. If you are expecting `Moment.js` functionality, be aware that this is a Python port and not all features are identical. Consider `arrow` or `pendulum` if core `moment` functionality is missing or problematic.

• TypeError: can't compare offset-naive and offset-aware datetimes

  cause Although `moment` has timezone capabilities, if you convert a `moment` object to a native `datetime` object without explicitly setting or managing its timezone, it might become naive. Comparing a naive `datetime` (no timezone info) with an aware `datetime` (with timezone info) will raise this error.
  fix Ensure all `datetime` objects you are comparing are either consistently naive or consistently aware. When converting from `moment` to `datetime`, explicitly handle timezones. For example, `my_moment.date.replace(tzinfo=desired_timezone)` or ensure `moment` objects are consistently aware with `.utcnow()` or `.timezone()` methods, and then use `moment_obj.datetime` to get an aware `datetime`.

Warnings

• deprecated The 'moment' library is no longer actively maintained (last GitHub activity in 2015) and is considered deprecated. It is recommended to use actively developed alternatives like `arrow` or `pendulum` for robust date/time handling, especially for new projects.
  Fix: Migrate to `arrow` (e.g., `pip install arrow`) or `pendulum` (e.g., `pip install pendulum`). These libraries offer similar or enhanced functionality with active development and better timezone support.
• gotcha Moment objects are mutable by default. Operations like `add()` or `subtract()` modify the original moment instance unless `clone()` is explicitly called first. This can lead to unexpected side effects in your code.
  Fix: Always use `.clone()` before performing operations that should not alter the original moment object. Example: `new_moment = original_moment.clone().add(days=1)`.
• gotcha The library's timezone handling, while present, may not be as robust or up-to-date with current DST rules and edge cases as more modern alternatives. There are open issues on GitHub related to timezone conflicts.
  Fix: For applications requiring precise and up-to-date timezone awareness, particularly across different regions and DST transitions, consider `pendulum` which is built for strict timezone handling, or `arrow` for a more user-friendly API with timezone awareness. Carefully test all timezone-sensitive operations if you must use `moment`.

Install

• pip install moment Install stable version

Imports

• moment

  import moment

  Primary import for the library.
• datetime

  from datetime import datetime

  Often used in conjunction with `moment` objects, which can convert to/from `datetime` instances.

Quickstart

This quickstart demonstrates how to create moment objects from current time or strings, perform basic arithmetic operations like adding time, and convert them to standard `datetime` objects. It also highlights the use of `clone()` to handle mutability.

import moment
from datetime import datetime

# Get the current moment (UTC)
now_utc = moment.utcnow()
print(f"Current UTC Moment: {now_utc.format('YYYY-MM-DD HH:mm:ss')}")

# Create a moment from a string
date_str = "2023-10-27 10:30:00"
my_moment = moment.date(date_str)
print(f"Parsed Moment: {my_moment.format('YYYY-MM-DD HH:mm:ss')}")

# Add some time
future_moment = my_moment.add(hours=2, minutes=15)
print(f"Future Moment: {future_moment.format('YYYY-MM-DD HH:mm:ss')}")

# Convert to a native datetime object
native_datetime = future_moment.date
print(f"Native datetime: {native_datetime}")

# Clone a moment to prevent mutation
original = moment.now()
modified = original.clone().add(days=1)
print(f"Original (should be unchanged): {original.format('YYYY-MM-DD')}")
print(f"Modified (1 day later): {modified.format('YYYY-MM-DD')}")