Excelize は、純粋な Go で記述されたライブラリで、XLAM / XLSM / XLSX / XLTM / XLTX ファイルの読み書きを可能にする一連の関数を提供します。Microsoft Excel™ 2007 以降で生成されたスプレッドシートドキュメントの読み取りと書き込みをサポートします。高い互換性により複雑なコンポーネントをサポートし、大量のデータを含むワークシートからデータを生成または読み取るためのストリーミング API を提供します。

場合によっては、既存の Excel ドキュメントコンテンツの読み込み、新しい Excel ドキュメントの作成、既存のドキュメント（テンプレート）に基づく新しい Excel ドキュメントの生成、Excel ドキュメントへのイメージの挿入、チャートなどの Excel ドキュメントをプログラムで操作する必要があります。 テーブルなどの要素。プラットフォーム間でこれらの操作を実装する必要がある場合があります。Excelize はこれらのニーズを容易に満たすことができます。

GitHub: github.com/xuri/excelize

Doc: xuri.me/excelize/ja

Excelize は v2.10.1 をリリースしました。このバージョンには、新機能、バグ修正、互換性向上など、40 以上のアップデートが含まれています。29 開発者がこのバージョンのコードに貢献しました。

リリースノート

このバージョンでの最も注目すべき変更点は次のとおりです:

互換性のヒント

3つのエクスポートされたエラー変数が削除されました: ErrStreamSetColStyle、ErrStreamSetColWidth、ErrStreamSetPanes。

新機能

• ChartDataPoint データ型を追加
• ChartSeries に DataPoint フィールドを追加
• ChartAxis に DropLines と HighLowLines フィールドを追加
• GraphicOptions に Name フィールドを追加
• 2つの定数を追加: MaxGraphicAltTextLength と MaxGraphicNameLength
• 7つのエクスポートされたエラー変数を追加: ErrFillType、ErrFillGradientColor、ErrFillGradientShading、ErrFillPatternColor、ErrFillPattern、ErrMaxGraphicAltTextLength、ErrMaxGraphicNameLength
• ハイパーリンクセルを取得するためのエクスポート関数 GetHyperLinkCells を追加。関連する問題 1607
• シート保護設定を取得するためのエクスポート関数 GetSheetProtection を追加
• AddComment 関数は、すでにコメントがあるセルにコメントを追加するとエラーを返すようになりました
• ICO 画像の挿入サポートを追加。関連する問題 2234
• CalcCellValue 関数が2つの数式関数をサポート: SORTBY と UNIQUE
• AddChart と AddChartSheet 関数がドーナツ、円グラフ、3D 円グラフのデータポイント色の設定をサポート。関連する問題 1904
• AddChart 関数が東アジアおよび複雑なスクリプトフォントのフォントファミリー設定をサポート
• AddChart 関数が面グラフと折れ線グラフのドロップライン（降下線）と高低線をサポート
• GetPictures 関数が部分的な書式設定プロパティを返せるようになりました。関連する問題 2157
• ストリーミングライターに列の表示/非表示を設定する SetColVisible 関数を追加。関連する問題 2075
• ストリーミングライターに列のグループ化を行う SetColOutlineLevel 関数を追加。関連する問題 2212
• AddShape と AddSlicer 関数が図形とスライサーの1セルアンカー配置をサポート
• GetSlicers 関数が1セルアンカー配置のスライサーの取得をサポート
• SetConditionalFormat、GetConditionalFormats、UnsetConditionalFormat 関数が 3 つの三角形、3 つの星、5 つのボックスのアイコンセット条件付き書式をサポート。関連する問題 2038
• UnsetConditionalFormat 関数がセル範囲内の特定のセルに対する条件付き書式ルールまたはデータ検証の削除をサポート
• AddPicture と AddPictureFromBytes 関数が画像名の設定をサポート
• AddChart と AddShape 関数がグラフと図形の名前と代替テキストの設定をサポート
• AddSlicer 関数がスライサーの代替テキストの設定をサポート
• グラフィック名と代替テキストの長さの検証を追加; 長さが制限を超えるとエラーを返す
• UTF-16対応の長さチェックと切り詰め機能を追加

互換性の向上

• 保存時に空の行を削除し、生成されるワークブックファイルサイズを削減

問題の修正

• GetCellValue と GetRows 関数が空文字列に対して共有文字列インデックスを返す v2.10.0 の回帰を修正。関連する問題 2240
• 一部のケースでピボットテーブル取得時に GetPivotTables がパニックする問題を修正
• 中国語の月名を含む特定の数値書式コードでセル値を読み取る際のパニックを修正。関連する問題 2224
• 一部のケースで暗号化されたワークブックを開く際のパニックを修正。関連する問題 2237
• ストリーミングライターの SetRow 関数使用時に列スタイルが欠落する問題を修正
• 一部のセル画像を返さない GetPictures を修正
• ライトテーマカラーインデックスのオーバーフローによるワークブック破損を修正
• 順序付けられていないセル参照でデータ検証セル範囲を誤って更新する DeleteDataValidation を修正
• 期間条件付き書式ルール設定時に破損したワークブックを生成する SetConditionalFormat を修正
• シート名からシングルクォートを削除することで一部のケースで参照解決に失敗する CalcCellValue を修正
• デフォルトのフォントまたは塗りつぶし使用時に重複スタイルを作成する NewStyle を修正。関連する問題 2254

パフォーマンスの最適化

• 計算キャッシュの追加と実際のデータ範囲への処理制限により CalcCellValue を最適化。関連する問題 2057 および 2223
• VLOOKUP の CalcCellValue 数式評価を最適化し、メモリ使用量と実行時間を約50%削減。関連する問題 2139
• 結合セル範囲のオーバーラップチェックの高速化とメモリ使用量の削減により GetMergeCells を最適化。関連する問題 2226
• 連分数漸化式を使用した変換により数値書式コードの適用を最適化

その他

• Go Modules はモジュールの更新に依存しています
• 単体テストとドキュメントの更新
• 多言語対応のドキュメント ウェブサイト: アラビア語、ドイツ語、英語、スペイン語、フランス語、イタリア語、日本語、韓国語、ポルトガル語、ロシア語、中国語 (簡体字)、中国語 (繁体字)
• excelize-wasm WebAssembly / JavaScript サポート向け NPM パッケージリリースアップデート
• excelize Python 向け PyPI パッケージリリースアップデート
• ExcelizeCs C# 向け NuGet .Net パッケージリリースアップデート

ありがとうございました

Excelize へのすべての貢献者に感謝します。以下は、このバージョンでコードに貢献した貢献者のリストです:

• pjh591029530 (Simmons25)
• Sang-Hyuk (SangHyuk)
• wangacc
• kenny-not-dead (Roman Sergeev)
• pegasscience-cyber
• jesusfelix951-lang
• felixdevelopper-hue
• shcabin
• radam9
• sqdtss
• IvanHristov98 (Ivan Hristov)
• yasarluo (Yasar Luo)
• DengY11 (Yi Deng)
• Kingson4Wu (Kingson4Wu)
• zhuzhengyang (Zhu Zhengyang)
• schbook
• rhinewg
• jpoz (James Pozdena)
• sides-flow (Sides)
• t4traw (Tatsuro Moriyama)
• ijustyce (杨春)
• d9c4
• imirkin (Ilia Mirkin)
• atmngw (Atsuki)
• Flashcqxg
• olivere (Oliver Eilhard)
• susautw (Su, Rin)
• ohauer (Olli Hauer)
• yan00353-0729