セル

RichTextRun は、リッチテキストランの設定を直接マップします。

type RichTextRun struct {
    Font *Font
    Text string
}

HyperlinkOpts を SetCellHyperlink に渡して、オプションのハイパーリンク属性（表示するテキストや画面のヒントテキストなど）を設定できます。

type HyperlinkOpts struct {
    Display *string
    Tooltip *string
}

FormulaOpts を SetCellFormula に渡して、他の数式タイプを使用することができます。

type FormulaOpts struct {
    Type *string // フォーミュラ タイプ
    Ref  *string // 共有式参照
}

セル値設定

func (f *File) SetCellValue(sheet, cell string, value interface{}) error

指定されたワークシート名とセル座標に基づいて、セルの値を設定します。この関数は、同時実行セーフをサポートします。指定された座標は、テーブルの最初の行にあるべきではありません。

デフォルトの日付形式は、time.Time タイプの値の m/d/yy h:mm であることに注意してください。SetCellStyle メソッドで数値フォーマットを設定できます。1900 年 1 月 0 日や 1900 年 2 月 29 日などの Excel で特殊な日付を設定する必要がある場合、これらの時刻は Go 言語の time.Time データ型で表すことはできません。セルの値を数値 0 または 60 に設定してから、セルの日時数値形式スタイルを作成してバインドしてください。

ブール値設定

func (f *File) SetCellBool(sheet, cell string, value bool) error

指定されたワークシート名とセル座標に基づいて、ブール型 (Boolean) のセルの値を設定します。

既定の文字の種類の値を設定する

func (f *File) SetCellDefault(sheet, cell, value string) error

指定されたワークシート名とセル座標に基づいて、文字セルの値を設定し、特殊文字に対してはフィルタされません。

実数を設定する

func (f *File) SetCellInt(sheet, cell string, value int64) error

指定されたワークシート名、セル参照、およびセル値によってセルの int64 型の値を設定する関数を提供します。

符号なし整数値を設定する

func (f *File) SetCellUint(sheet, cell string, value uint64) error

SetCellUint は、指定されたワークシート名、セル参照、およびセル値によってセルの符号なし整数データ型の値を設定する関数を提供します。

浮動小数点値の設定

func (f *File) SetCellFloat(sheet, cell string, value float64, precision, bitSize int) error

SetCellFloat は浮動小数点値をセルに設定します。precision パラメータは小数点以下の桁数を指定しますが、-1 は数値を表すために必要な数の小数点以下の桁数を使用する特別な値です。bitSize は、float32 または float64 が最初に値に使用されたかどうかに応じて、32 または 64 です。

文字列値の設定

func (f *File) SetCellStr(sheet, cell, value string) error

指定したワークシート名とセル座標に基づいて文字セルの値を設定すると、文字は特殊文字でフィルタリングされ、文字列の累積長は 32767 を超えてはならず、余分な文字は無視されます。

セルスタイルの設定

func (f *File) SetCellStyle(sheet, topLeftCell, bottomRightCell string, styleID int) error

指定されたワークシート名、セル座標領域、およびスタイルインデックスに基づいて、セルの値を設定します。この関数は、同時実行セーフをサポートします。スタイルインデックスは NewStyle 関数を使用して取得できます。同じ座標領域内の diagonaldown と diagonalup は同じ色で保持する必要があることに注意してください。SetCellStyle は、セルの既存のスタイルを上書きし、スタイルを既存のスタイルに追加またはマージしません。

• 例1、ワークシート D7 セル Sheet1 の境界線のスタイルを設定します:

style, err := f.NewStyle(&excelize.Style{
    Border: []excelize.Border{
        {Type: "left", Color: "0000FF", Style: 3},
        {Type: "top", Color: "00FF00", Style: 4},
        {Type: "bottom", Color: "FFFF00", Style: 5},
        {Type: "right", Color: "FF0000", Style: 6},
        {Type: "diagonalDown", Color: "A020F0", Style: 8},
        {Type: "diagonalUp", Color: "A020F0", Style: 8},
    },
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

セル D7 の4つの境界は、NewStyle 関数を呼び出すときにパラメータに関連する異なるスタイルと色に設定されており、その章のドキュメントを参照するために異なるスタイルを設定する必要があります。

• 例2では、ワークシート D7 セル Sheet1 という名前のグラデーションスタイルを設定します:

style, err := f.NewStyle(&excelize.Style{
    Fill: excelize.Fill{Type: "gradient", Color: []string{"FFFFFF", "E0EBF5"}, Shading: 1},
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

セル D7 はグラデーション効果の塗りつぶしに設定され、グラデーションの塗りつぶし効果は NewStyle 関数を呼び出すときのパラメーターに関連しており、その章のドキュメントを参照するために異なるスタイルを設定する必要があります。

• 例3では、ワークシート D7 セル Sheet1 という名前の単色の塗りつぶしを設定します:

style, err := f.NewStyle(&excelize.Style{
    Fill: excelize.Fill{Type: "pattern", Color: []string{"E0EBF5"}, Pattern: 1},
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

セル D7 は単色の塗りつぶしに設定されています。

• 例4では、ワークシート D7 セルの文字間隔と回転角度を Sheet1 という名前で設定します:

f.SetCellValue("Sheet1", "D7", "Style")
style, err := f.NewStyle(&excelize.Style{
    Alignment: &excelize.Alignment{
        Horizontal:      "center",
        Indent:          1,
        JustifyLastLine: true,
        ReadingOrder:    0,
        RelativeIndent:  1,
        ShrinkToFit:     true,
        TextRotation:    45,
        Vertical:        "",
        WrapText:        true,
    },
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

• 例5の日付と時刻は、Excel が実数で表され、たとえば 2017/7/4 12:00:00 PM が番号 42920.5 で表すことができる。Sheet1 という名前のワークシート D7 セルの時刻形式を設定します:

f.SetCellValue("Sheet1", "D7", 42920.5)
f.SetColWidth("Sheet1", "D", "D", 13)
style, err := f.NewStyle(&excelize.Style{NumFmt: 22})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

セル D7 は時刻形式で設定されています。 時刻形式のセルの幅が狭すぎて完全に表示できない場合は、#### と表示され、調整列の幅をドラッグアンドドロップするか、適切なサイズに設定するために SetColWidth 関数を呼び出すことによって、列の大きさが適切であることを確認します。

• 例6、ワークシート D7 という名前のセルのフォント、フォントサイズ、色、および傾きのスタイルを設定します：

f.SetCellValue("Sheet1", "D7", "Excel")
style, err := f.NewStyle(&excelize.Style{
    Font: &excelize.Font{
        Bold:   true,
        Italic: true,
        Family: "Times New Roman",
        Size:   36,
        Color:  "777777",
    },
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

• 例7、ワークシート D7 セル Sheet1 という名前をロックして非表示にします:

style, err := f.NewStyle(&excelize.Style{
    Protection: &excelize.Protection{
        Hidden: true,
        Locked: true,
    },
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "D7", "D7", style)

セルをロックしたり数式を非表示にしたりするには、ワークシートを保護します。「校閲」タブで、「ワークシートの保護」をクリックします。

ハイパーリンクの設定

func (f *File) SetCellHyperLink(sheet, cell, link, linkType string, opts ...HyperlinkOpts) error

指定したワークシート、セル座標、リンクされたリソース、およびリソースの種類に基づいて、セルのハイパーリンクを設定します。 リソースの種類は、外部リンクアドレス External とブック内部の場所のリンク Location 2 種類に分割されます。ワークシート内の最大ハイパーリンク数は 65530 です。この関数は、セルのハイパーリンクを設定するためにのみ使用され、セルの値には影響しません。セルの値を設定する必要がある場合は、SetCellStyle や SetSheetRow などの他の関数を使用してください。

• 例1、ワークシート A3 セル Sheet1 という名前の外部リンクを追加します:

display, tooltip := "https://github.com/xuri/excelize", "Excelize on GitHub"
if err := f.SetCellHyperLink("Sheet1", "A3",
    "https://github.com/xuri/excelize", "External", excelize.HyperlinkOpts{
        Display: &display,
        Tooltip: &tooltip,
    }); err != nil {
    fmt.Println(err)
}
// セルのフォントとアンダースコアのスタイルを設定する
style, err := f.NewStyle(&excelize.Style{
    Font: &excelize.Font{Color: "1265BE", Underline: "single"},
})
if err != nil {
    fmt.Println(err)
}
err = f.SetCellStyle("Sheet1", "A3", "A3", style)

• 例2では、ワークシート A3 セル Sheet1 という名前の内部の場所のリンクを追加します:

err := f.SetCellHyperLink("Sheet1", "A3", "Sheet1!A40", "Location")

セルのリッチテキストを設定する

func (f *File) SetCellRichText(sheet, cell string, runs []RichTextRun) error

SetCellRichText は、特定のワークシートによってリッチテキストを含むセルを設定する関数を提供します。

たとえば、Sheet1という名前のワークシートの A1 セルにリッチテキストを設定します：

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    if err := f.SetRowHeight("Sheet1", 1, 35); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SetColWidth("Sheet1", "A", "A", 44); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SetCellRichText("Sheet1", "A1", []excelize.RichTextRun{
        {
            Text: "bold",
            Font: &excelize.Font{
                Bold:   true,
                Color:  "2354E8",
                Family: "Times New Roman",
            },
        },
        {
            Text: " and ",
            Font: &excelize.Font{
                Family: "Times New Roman",
            },
        },
        {
            Text: "italic ",
            Font: &excelize.Font{
                Bold:   true,
                Color:  "E83723",
                Italic: true,
                Family: "Times New Roman",
            },
        },
        {
            Text: "text with color and font-family,",
            Font: &excelize.Font{
                Bold:   true,
                Color:  "2354E8",
                Family: "Times New Roman",
            },
        },
        {
            Text: "\r\nlarge text with ",
            Font: &excelize.Font{
                Size:  14,
                Color: "AD23E8",
            },
        },
        {
            Text: "strike",
            Font: &excelize.Font{
                Color:  "E89923",
                Strike: true,
            },
        },
        {
            Text: " superscript",
            Font: &excelize.Font{
                Color:     "DBC21F",
                VertAlign: "superscript",
            },
        },
        {
            Text: " and ",
            Font: &excelize.Font{
                Size:      14,
                Color:     "AD23E8",
                VertAlign: "baseline",
            },
        },
        {
            Text: "underline",
            Font: &excelize.Font{
                Color:     "23E833",
                Underline: "single",
            },
        },
        {
            Text: " subscript.",
            Font: &excelize.Font{
                Color:     "017505",
                VertAlign: "subscript",
            },
        },
    }); err != nil {
        fmt.Println(err)
        return
    }
    style, err := f.NewStyle(&excelize.Style{
        Alignment: &excelize.Alignment{
            WrapText: true,
        },
    })
    if err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SetCellStyle("Sheet1", "A1", "A1", style); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

リッチテキスト形式を取得する

func (f *File) GetCellRichText(sheet, cell string) ([]RichTextRun, error)

指定されたワークシートとセル座標に従って、指定されたセルのリッチテキスト形式を取得します。

セル値取得

func (f *File) GetCellValue(sheet, cell string, opts ...Options) (string, error)

指定されたワークシートとセルの座標に基づいてセルの値を取得すると、戻り値は string 型に変換されます。この関数は、同時実行セーフをサポートします。セルの値にセル書式を適用できる場合は、適用された値が返されます。差し込み印刷範囲内のすべてのセルの値は同じです。

セルタイプを取得します

func (f *File) GetCellType(sheet, cell string) (CellType, error)

GetCellType は、スプレッドシートファイル内の指定されたワークシート名と軸によってセルのデータ型を取得する関数を提供します。

列ごとにすべてのセル値を取得する

func (f *File) GetCols(sheet string, opts ...Options) ([][]string, error)

GetCols は、指定されたワークシート名に基づいてワークシートの列ごとにすべてのセルの値を取得し、2 次元配列として返されます。ここで、セルの値は stringタイプに変換されます。セル形式をセルの値に適用できる場合は、適用された値が使用されます。それ以外の場合は、元の値が使用されます。

たとえば、Sheet1 という名前のワークシートの列ごとにすべてのセルの値を取得してトラバースします。

cols, err := f.GetCols("Sheet1")
if err != nil {
    fmt.Println(err)
    return
}
for _, col := range cols {
    for _, rowCell := range col {
        fmt.Print(rowCell, "\t")
    }
    fmt.Println()
}

行ごとにすべてのセル値を取得する

func (f *File) GetRows(sheet string, opts ...Options) ([][]string, error)

GetRows は、指定されたワークシート名でシート内のすべての行を返し、2 次元配列として返されます。ここで、セルの値は string タイプに変換されます。セル形式をセルの値に適用できる場合は、適用された値が使用されます。それ以外の場合は、元の値が使用されます。GetRows は、値セルまたは数式セルを含む行をフェッチしました。各行の末尾にある空白のセルはスキップされるため、各行の長さが一致しない場合があります。

たとえば、Sheet1 という名前のワークシートの行ごとにすべてのセルの値を取得してトラバースします。

rows, err := f.GetRows("Sheet1")
if err != nil {
    fmt.Println(err)
    return
}
for _, row := range rows {
    for _, colCell := range row {
        fmt.Print(colCell, "\t")
    }
    fmt.Println()
}

ハイパーリンクセルを取得

func (f *File) GetHyperLinkCells(sheet, linkType string) ([]string, error)

GetHyperLinkCells は、指定されたワークシート名とリンクタイプでハイパーリンクを含むセル参照を返します。オプションのパラメータ linkType は特定のリンクタイプに使用され、オプションの値は External（ウェブサイトリンク用）、Location（このワークブック内のセルへの移動用）、None（リンクなし）です。linkType が空の場合、ワークシート内のすべてのハイパーリンクが返されます。

ハイパーリンクを取得

func (f *File) GetCellHyperLink(sheet, cell string) (bool, string, error)

指定されたワークシート名とセル座標に基づいてセルのハイパーリンクを取得し、セルにハイパーリンクがある場合は true とリンクアドレスが返され、それ以外の場合は false と空のリンクアドレスが返されます。

たとえば、Sheet1 という名前のワークシートのハイパーリンクを H6 セルの座標で取得します:

link, target, err := f.GetCellHyperLink("Sheet1", "H6")

スタイルインデックスの取得

func (f *File) GetCellStyle(sheet, cell string) (int, error)

指定されたワークシート名とセルの座標に基づいてセルスタイルのインデックスを取得し、セルのスタイルをコピーするときに SetCellStyle 関数を呼び出すパラメーターとして使用できるインデックスを取得します。

セルを結合

func (f *File) MergeCell(sheet, topLeftCell, bottomRightCell string) error

指定したシート名 (大文字と小文字に敏感) とセルの座標範囲に基づいてセルを結合します。結合領域内には左上のセルの値のみが保持され、他のセルの値は無視されます。たとえば、Sheet1 という名前のワークシートの D3:E9 領域のセルを結合します。

err := f.MergeCell("Sheet1", "D3", "E9")

指定したセルの座標領域が既に存在する他の結合セルと重なっている場合、既存の結合セルは削除されます。

セルの結合を解除

func (f *File) UnmergeCell(sheet, topLeftCell, bottomRightCell string) error

UnmergeCell は、指定された座標領域の結合を解除する機能を提供します。たとえば、Sheet1 の領域 D3E9 のマージを解除します:

err := f.UnmergeCell("Sheet1", "D3", "E9")

重要：重複した領域もマージされません。

セルを結合する

func (f *File) GetMergeCells(sheet string, withoutValues ...bool) ([]MergeCell, error)

GetMergeCells は、特定のワークシートからすべての結合セルを取得する関数を提供します。withoutValues パラメータを true に設定すると、結合セルのセル値は返されず、範囲参照のみが返されます。例えば、Sheet1 のすべての結合セルを取得するには、次のようにします:

mergeCells, err := f.GetMergeCells("Sheet1")

セル値のない結合セルを取得する場合は、次のコードを使用できます:

mergeCells, err := f.GetMergeCells("Sheet1", true)

結合されたセルの値を取得する

func (m *MergeCell) GetCellValue() string

GetCellValue は、結合されたセル値を返します。

マージされた範囲の左上のセル座標を取得します

func (m *MergeCell) GetStartAxis() string

GetStartAxis は、マージされた範囲の左上のセル座標を返します（例：C2）。

マージされた範囲の右下のセル座標を取得します

func (m *MergeCell) GetEndAxis() string

GetEndAxis は、マージされた範囲の右下のセル座標を返します（例：D4）。

画像セルを取得する

func (f *File) GetPictureCells(sheet string) ([]string, error)

GetPictureCells は、特定のワークシート名でワークシート内のすべてのピクチャ セル参照を返します。

コメント追加

func (f *File) AddComment(sheet string, comment Comment) error

AddComment は、ワークシートのインデックス、セル、および書式設定（作成者やテキストなど）を指定して、シートにコメントを追加するメソッドを提供します。作成者の最大文字数は 255 文字、テキストの最大文字数は 32512 文字です。また、各セルにはコメントを 1 つしか設定できません。既にコメントが設定されているセルにコメントを追加するとエラーが発生します。例えば、Sheet1!A3 にコメントを追加するには、次のようにします。

err := f.AddComment("Sheet1", excelize.Comment{
    Cell:   "A3",
    Author: "Excelize",
    Paragraph: []excelize.RichTextRun{
        {Text: "Excelize: ", Font: &excelize.Font{Bold: true}},
        {Text: "This is a comment."},
    },
})

コメントを得る

func (f *File) GetComments(sheet string) ([]Comment, error)

GetComments は、指定されたワークシート名でワークシート内のすべてのコメントを取得します。

コメントを削除

func (f *File) DeleteComment(sheet, cell string) error

DeleteComment は、特定のワークシートでシート内のコメントを削除するメソッドを提供します。 たとえば、Sheet1!A30 のコメントを削除します。

err := f.DeleteComment("Sheet1", "A30")

無視されたエラーを追加する

func (f *File) AddIgnoredErrors(sheet, rangeRef string, ignoredErrorsType IgnoredErrorsType) error

AddIgnoredErrors は、セル範囲のエラーを無視する方法を提供します。たとえば、Sheet1 のセル範囲 D15 C18:D19 の「数値がテキストとして保存されています」エラーを無視します。

err := f.AddIgnoredErrors("Sheet1", "D15 C18:D19", excelize.IgnoredErrorsNumberStoredAsText)

セル式の設定

func (f *File) SetCellFormula(sheet, cell, formula string, opts ...FormulaOpts) error

SetCellFormula は、指定されたワークシート名およびセル式の設定に従って、セルに式が取得されるように設定する関数を提供します。数式セルの結果は、ワークシートが Office Excel アプリケーションで開かれた場合、または計算されたセル値を取得する場合に CalcCellValue 関数を使用して計算できます。Excel アプリケーションがブックを開いたときに数式を自動的に計算しない場合は、セルの数式関数を設定した後に UpdateLinkedValue を呼び出してください。

• 例1, Sheet1 のセル A3 に通常の数式 =SUM(A1,B1) を設定します：

err := f.SetCellFormula("Sheet1", "A3", "SUM(A1,B1)")

• 例2, Sheet1 のセル A3 に1次元の垂直定数配列式（列配列） 1;2;3 を設定します：

err := f.SetCellFormula("Sheet1", "A3", "{1;2;3}")

• 例3, Sheet1 のセル A3 に1次元の水平定数配列（行配列）の数式 "a","b","c" を設定します：

err := f.SetCellFormula("Sheet1", "A3", "{\"a\",\"b\",\"c\"}")

• 例4, Sheet1 のセル A3 に2次元定数配列数式 {1,2;"a","b"} を設定します：

formulaType, ref := excelize.STCellFormulaTypeArray, "A3:A3"
err := f.SetCellFormula("Sheet1", "A3", "{1,2;\"a\",\"b\"}",
    excelize.FormulaOpts{Ref: &ref, Type: &formulaType})

• 例5, Sheet1 のセル A3 に範囲配列数式 A1:A2 を設定します：

formulaType, ref := excelize.STCellFormulaTypeArray, "A3:A3"
err := f.SetCellFormula("Sheet1", "A3", "A1:A2",
    excelize.FormulaOpts{Ref: &ref, Type: &formulaType})

• 例6, Sheet1 のセル C1:C5 に共有数式 =A1+B1 を設定します。C1 はマスターセルです：

formulaType, ref := excelize.STCellFormulaTypeShared, "C1:C5"
err := f.SetCellFormula("Sheet1", "C1", "A1+B1",
    excelize.FormulaOpts{Ref: &ref, Type: &formulaType})

• 例7, Sheet1 のセル C2 にテーブル数式 =SUM(Table1[[A]:[B]]) を設定します：

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    for idx, row := range [][]interface{}{{"A", "B", "C"}, {1, 2}} {
        if err := f.SetSheetRow("Sheet1", fmt.Sprintf("A%d", idx+1), &row); err != nil {
            fmt.Println(err)
            return
        }
    }
    if err := f.AddTable("Sheet1",
        &excelize.Table{
            Range:     "A1:C2",
            Name:      "Table1",
            StyleName: "TableStyleMedium2",
        }); err != nil {
        fmt.Println(err)
        return
    }
    formulaType := excelize.STCellFormulaTypeDataTable
    if err := f.SetCellFormula("Sheet1", "C2", "SUM(Table1[[A]:[B]])",
        excelize.FormulaOpts{Type: &formulaType}); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

セル式を取得する

func (f *File) GetCellFormula(sheet, cell string) (string, error)

指定されたワークシート名とセルの座標に基づいて、セルの数式を取得します。

セル値を計算する

func (f *File) CalcCellValue(sheet, cell string, opts ...Options) (string, error)

CalcCellValue は、計算されたセル値を取得する関数を提供します。この機能は現在処理中です。反復計算、暗黙的交差、明示的交差、配列式、テーブル式、およびその他のいくつかの式は現在サポートされていません。

サポートされている式：