1. Top
  2. yamori
  3. Files
  4. docs
  5. src
  6. file-types.md
yamori

有給休暇計算を主目的とした簡易勤怠管理システム

  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. 13
  14. 14
  15. 15
  16. 16
  17. 17
  18. 18
  19. 19
  20. 20
  21. 21
  22. 22
  23. 23
  24. 24
  25. 25
  26. 26
  27. 27
  28. 28
  29. 29
  30. 30
  31. 31
  32. 32
  33. 33
  34. 34
  35. 35
  36. 36
  37. 37
  38. 38
  39. 39
  40. 40
  41. 41
  42. 42
  43. 43
  44. 44
  45. 45
  46. 46
  47. 47
  48. 48
  49. 49
  50. 50
  51. 51
  52. 52
  53. 53
  54. 54
  55. 55
  56. 56
  57. 57
  58. 58
  59. 59
  60. 60
  61. 61
  62. 62
  63. 63
  64. 64
  65. 65 
# ファイル形式

<!--
SPDX-License-Identifier: AGPL-3.0-only
Copyright 2025 Shota FUJI

This program is free software: you can redistribute it and/or modify it under the terms
of the GNU Affero General Public License as published by the Free Software Foundation,
either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along
with this program.  If not, see <http://www.gnu.org/licenses/>.
-->

Yamori では以下の形式のファイルが利用できます。

- [Excel ワークブック](#excel-ワークブック)
- [CSV](#csv)
- [TSV](#tsv)

ファイル内の構造やファイル名が仕様に沿っている限り、どのデータにどのファイル形式を利用するのかは自由です。

## Excel ワークブック

Microsoft Excel のワークブック (`.xlsx`) です。
シート単位で読み込むため、一つのワークブックに複数のデータを含めることも可能です。
（例: 社員マスタと勤怠記録を同じワークブックで管理する）

!!! note "確認中"

    どの Excel バージョンのワークブックまで読み込めるかは現在確認中です。

## CSV

カンマ (`,`) で列を区切り、改行 (CR+LF) で行が区切られたテキストファイルです。
文字コードは UTF-8 のみサポートしています。
**最初のヘッダ行は必須です**。

CSV に対応したソフトウェア・システムと連携させる場合に便利です。

ファイルは[RFC 4180](https://www.rfc-editor.org/rfc/rfc4180)に準拠している必要があります。
(`text/csv;charset=utf-8`)

*[CSV]: Comma-Separated Values

## TSV

タブ文字 ( ++tab++ で入力できる空白文字)で列を区切り、改行 (LFまたはCR+LF) で行が区切られたテキストファイルです。
文字コードは UTF-8 のみサポートしています。

Yamori のデータファイルを読み込むプログラムを書く場合に便利です。

ファイルは [IANA に登録されている定義](https://www.iana.org/assignments/media-types/text/tab-separated-values)に準拠している必要があります。
(`text/tab-separated-values;charset=utf-8`)

*[TSV]: Tab-Separated Values

## 将来サポート予定のファイル形式

- マクロ有効 Excel ワークブック (`.xlsm`)
- JSON (`.json`, `.jsonc`)