之后是一个表格，其中第一列显示了每一行的月份日期（除了第一行，总是1）。

接下来七列显示了每天的工时。因为我是在星期六写这个README.md，在sat下，所以您看到我在星期六工作了3小时，星期天工作了2小时。

在最后一列中，总结了每周的工作时间，在表格的末尾，它说我们在整个3月份工作的时间相同，- 虽然在我们的例子中看起来没有用 - 最后它总结了所有显示工作的总工作时间。

筛选视图

您可以在-r后面添加时间范围（请参阅下面的范围部分以了解格式）或使用-t来通过时间或标签过滤工作。

选择数据库

通常jobber使用配置文件中列出的数据库（请参阅下面的配置部分）。使用-f您可以覆盖要使用的数据库文件。

▶ jobber -f ~/my_jobber.json` [...]

日期、时间、持续时间和范围格式

日期和/或时间

日期和时间必须以以下格式之一输入

时间格式内不允许有空格，并且日期和时间格式也可以互换为时间然后是日期。

如果日期或时间缺失，将使用当前时间。

如果一起给出开始和结束，只需定义一个日期。

持续时间

持续时间必须以以下格式之一输入

范围

时间或位置范围必须以以下格式之一输入

当使用“从时间到时间”或“从时间”格式与“不包含年份的日期”一起时，请记住三个点将位于中间（例如：31.1...1.2.）。

导入和导出

遗留 CSV 导入

要从旧版本的 Ruby 的 jobber 导入旧数据库格式，可以使用 --legacy-import

▶ jobber --legacy-import ~/my_old_jobber.dat 
Loaded database (2 entries) from file 'jobber.json'
Imported 125 jobs added new tags  consult ,  meeting ,  my_client ,  training .
Saved database into file 'jobber.json'

Jobber 显示它已成功导入 125 项工作，并且这次导入带来了四个新标签（再次说明：标签名称将被着色，但在这里的 Markdown 文本中不会）。

CSV 导出

使用选项 -E，可以将数据库或其部分导出为 CSV 文件，例如从中创建发票。

▶ jobber -E
Loaded database (3 entries) from file 'jobber.json'
"Tags","Start","Hours","Message"
"","03/04/2023 08:15",2.5,"What I did early this morning"
"","03/04/2023 16:25",0.5,"Did some nice work"
"meeting","03/05/2023 21:24",2,"meeting about new design"
Database unchanged.

如你所见，默认输出是一个包含以下列的CSV文件： tags、start、hours 和 message。

导出的条目会自动按开始日期和时间排序，方便您使用。

要将输出写入文件，请使用shell的管道功能（例如 jobber -E > out.csv）

要更改要导出的列，可以使用选项 --csv（可能的值有

▶ jobber -E --csv pos,start,end
Loaded database (3 entries) from file 'jobber.json'
"pos","start","end"
2,"03/04/2023 08:15","03/04/2023 10:45"
1,"03/04/2023 16:25","03/04/2023 16:34"
3,"03/05/2023 21:24","03/05/2023 23:24"
Database unchanged.

在这个例子中，我们只导出了每个工作的 pos、start 和 hours。

您还可以使用选项 -E 指定范围，就像您创建报告时一样

▶ jobber -E 3/4,0:00..12:00
Loaded database (3 entries) from file 'jobber.json'
"tags","start","hours","message"
"","03/04/2023 08:15",2.5,"What I did early this morning"
Database unchanged.

如您所见，现在只导出了一个工作。

警告

Jobber 对您的命令进行多个合理性检查。每当出现似乎不合适的情况时，您将收到警告，并会被询问是否仍要继续。

您要添加的工作与现有工作重叠

您即将添加一个与另一个工作在时间上重叠的工作。

▶ jobber -s 3/4,9:00 -e 10:00
Loaded database (3 entries) from file 'jobber.json'
There is one warning you have to omit:

WARNING 1) The job you want to add overlaps existing one(s):

Job you want to add:

  Start: Sat Mar 04 2023, 09:00
    End: Sat Mar 04 2023, 10:00
  Hours: 1


Existing overlapping jobs:

    Pos: 2
  Start: Sat Mar 04 2023, 08:15
    End: Sat Mar 04 2023, 10:45
  Hours: 2.5
Message: What I did early this morning

Total: 1 job(s), 2.5 hours

Do you still want to add this job? (y/N)

Jobber 列出您即将添加的工作，然后是与之重叠的工作。

如果您开始一个工作（没有给出结束时间），并且开始时间早于任何现有工作，则假设结束时间可能是现在，因此您可能会收到警告。然后检查您的输入，如果这是故意的，回答 y 以继续或 n 以取消。

您使用了某些未知标记

使用选项 -t 您给出了某些当前未知的标签名称，然后 Jobber 会询问这是否是一个错误，或者您是否想添加新标签

▶ jobber -s -t consulting 
Loaded database (3 entries) from file 'jobber.json'
There is one warning you have to omit:

WARNING 1) You have used some tags ( consulting ) which are unknown so far. Continue if you want to create them.
Do you still want to add this job? (y/N)

在这种情况下，标签 consulting 是未知的。

要列出已知的标签，可以使用选项 -T（见 标签 部分）。

错误

数据库为空

您尝试继续一个现有工作，但数据库为空。

全局配置错误

您的配置（.config/jobber/config.toml）中有一个错误。

I/O 错误

读取或写入文件失败。

JSON 错误

解析 JSON 错误，数据库文件可能已损坏。

还有一个开放的工作

您尝试开始一个新工作，但现在有一个开放的工作需要先结束，然后才能添加新工作。

没有开放的工作

您尝试结束一个开放的工作，但没有任何工作。

工作结束时间早于开始时间

结束和开始时间看起来顺序颠倒了。

用户取消

在询问后，您拒绝了一些内容。

同一工作内不能使用标记，因为它们的配置不同

您使用了具有不同配置的两个标签，这是不允许的。

用户需要输入消息

您需要输入一条消息，但没有输入。

未知列名

在将工作导出到CSV文件时，您声明了一个未知的列名（只有 pos、start、end、hours、message 和 tags 是可用的）。

输出文件已存在

尝试写入已存在的输出文件。

日期/时间解析错误

日期和或时间的解析错误。

在指定位置未找到工作

您给出的是一个不在数据库中的位置。

需要一个值

需要为 '-t ' 输入一个值，但没有提供。

数据库中的工作太少，无法处理范围内的操作

您给出的是一个超出数据库范围的定位范围。

范围解析失败

您给出的是一个无法解析的范围。

持续时间解析失败

您给出的是一个无法解析的持续时间。

部分日期和时间的解析失败

您给出的是一个无法解析的部分日期和时间。

配置

数据库位置

在第一次启动时，Jobber 创建一个配置文件（通常在您的家目录中的 .config/jobber/config.toml）。

该文件当前只有一个条目，即

database = 'jobber.json'

如果您想将数据库放在其他地方，请更改数据库路径。

数据库内部配置

在jobber数据库中有一些设置可能需要更改

• 工作时间解析度
• 您的时薪
• 每天最大工作时间

在jobber中，有一个基本配置，但您也可以通过在更改设置时添加带有-t的标签列表来为不同的客户附加配置，以实现不同客户的配置。

设置基本配置

工作时间解析度

使用-R可以设置工作时间解析度。默认值为0.25，表示半小时。因此，如果您添加一个持续时间为16分钟的工作，这将四舍五入到30分钟。

例如，您可能将基本解析度更改为半小时，如下所示

▶ jobber -R 0.5       
Beginning new database file 'jobber.json'
Changed the following default configuration values:

Resolution: 0.5 hours

Saved database into file 'jobber.json'

每小时工资率

要更改您的时薪，请使用-P。默认值没有设置，因此如果您不设置它，则不会显示任何费率。如果您这样做，jobber在列出时会列出成本。

▶ jobber -P 100
Loaded database (0 entries) from file 'jobber.json'
Changed the following default configuration values:

Payment per hour: 100

Saved database into file 'jobber.json'

每天最大小时数

如果您使用-H设置此值，并且工作天数超过此值，则报告中的这些天数将被标记为黄色。在列出超出此值的工作时，这些工作将被标记为黄色。

因此，如果您想将每天的最大工作时间更改为8小时，请使用以下方法

▶ jobber -H 8  
Loaded database (0 entries) from file 'jobber.json'
Changed the following default configuration values:

Maximum work time: 8 hours

Saved database into file 'jobber.json'

为特定标记设置配置

如果您有多个客户，并且每个客户有不同的支付率，您可以在设置配置时添加标签选项-t。

显示配置

要显示您的配置（s），请使用选项-C

▶ jobber -C  
Loaded database (3 entries) from file 'jobber.json'
Base Configuration:

Resolution: 0.5 hours
Payment per hour: 100
Maximum work time: 8 hours

Database unchanged.