Goment 项目使用教程

1. 项目的目录结构及介绍

Goment 是一个 Go 语言的日期时间处理库，其目录结构如下：

goment/
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── TODO.md
├── bench_test.go
├── doc.go
├── duration.go
├── duration_test.go
├── example_test.go
├── goment.go
├── goment_add_subtract.go
├── goment_add_subtract_test.go
├── goment_compare.go
├── goment_compare_test.go
├── goment_conversion.go
├── goment_conversion_test.go
├── goment_creation.go
├── goment_creation_test.go
├── goment_duration.go
├── goment_duration_test.go
├── goment_format.go
├── goment_format_test.go
├── goment_get_set.go
├── goment_get_set_test.go
├── goment_locale.go
├── goment_locale_test.go
├── goment_manipulate.go
├── goment_manipulate_test.go
├── goment_query.go
├── goment_query_test.go
├── goment_timezone.go
├── goment_timezone_test.go
├── goment_utils.go
├── goment_utils_test.go
├── go.mod
├── go.sum
├── i18n/
│   ├── en.go
│   ├── es.go
│   ├── fr.go
│   ├── it.go
│   ├── ja.go
│   ├── ko.go
│   ├── pt.go
│   ├── ru.go
│   ├── zh-cn.go
│   └── zh-tw.go
└── testdata/
    └── locales.json

目录结构介绍

• CHANGELOG.md: 项目更新日志。
• CONTRIBUTING.md: 贡献指南。
• LICENSE: 项目许可证。
• README.md: 项目介绍和使用说明。
• TODO.md: 待办事项列表。
• bench_test.go: 性能测试文件。
• doc.go: 项目文档。
• duration.go 和 duration_test.go: 持续时间处理相关代码和测试。
• example_test.go: 示例代码。
• goment.go: 主文件，包含 Goment 结构体和基本方法。
• goment_*.go 和 goment_*_test.go: 各种功能模块的实现和测试文件。
• go.mod 和 go.sum: Go 模块文件。
• i18n/: 国际化支持文件。
• testdata/: 测试数据文件。

2. 项目的启动文件介绍

Goment 项目的启动文件是 goment.go，其中定义了 Goment 结构体和一些基本方法，如创建新的 Goment 实例、获取当前时间等。

package goment

import (
    "time"
)

// Goment represents a moment in time.
type Goment struct {
    time time.Time
    locale string
}

// New creates a new Goment instance.
func New() *Goment {
    return &Goment{
        time: time.Now(),
        locale: "en",
    }
}

// Now returns the current local time.
func Now() *Goment {
    return New()
}

3. 项目的配置文件介绍

Goment 项目没有传统的配置文件，其配置主要通过代码进行设置。例如，可以通过以下方式设置时区和语言：

g := goment.New()
g.SetLocale("zh-cn") // 设置语言为中文
g.SetTimeZone("Asia/Shanghai") // 设置时区为上海

国际化支持文件位于 i18n/ 目录下，每个文件对应一种语言，如 zh-cn.go 对应中文。

package i18n

var zhCN = map[string]string{
    "months": "一月_二月_三月_四月_五月_六月_七月_八月_九月_十月_