快速开始

使用 Pixi 安装

Morrow 已发布到 Modular 官方社区 channel。 在已经配置好 Mojo 的 Pixi 工作区中，添加 Modular Community channel 后即可安装：

pixi workspace channel add --prepend https://repo.prefix.dev/modular-community
pixi add morrow

该包会把与编译器版本兼容的 morrow.mojoc 安装到当前环境，其他 Mojo 包可以直接导入。

从源码开发

先安装 uv，再在仓库根目录运行：

make install
uv run mojo repl

make install 会使用 Python 3.14 创建或复用 .venv，并安装锁定版本的 Mojo。从仓库根目录启动 REPL 后，可以直接导入 morrow 源码包。

构建本地包

如需在本地测试，或不通过 Pixi 分发，可以构建预编译包：

make build

该命令会生成 morrow.mojoc。预编译包必须使用与构建时相同版本的 Mojo 编译器导入。普通项目建议优先使用上面的 Modular Community 包，让 Pixi 根据声明的 Mojo 兼容范围解析依赖。

导入

from morrow import Morrow, TimeDelta, TimeZone

创建值

var now = Morrow.now()
var utc_now = Morrow.utcnow()
var from_timestamp = Morrow.utcfromtimestamp("1767225600.5")
var from_iso = Morrow.fromisoformat("20260101T030405.123456Z")
var fixed = Morrow.get(1767225600.5, "+05:30")

格式化输出

var value = Morrow(2026, 1, 1, 3, 4, 5, 123456, TimeZone.from_utc("UTC"))

print(value)
print(value.isoformat())
print(value.format("YYYY-MM-DD HH:mm:ss.SSSSSS ZZ"))
print(value.strftime("%Y-%m-%d %H:%M:%S.%f %z %Z"))