통합 문서

Options 은 스프레드 시트를 읽고 쓰는 옵션을 정의합니다.

type Options struct {
    MaxCalcIterations uint
    Password          string
    RawCellValue      bool
    UnzipSizeLimit    int64
    UnzipXMLSizeLimit int64
    ShortDatePattern  string
    LongDatePattern   string
    LongTimePattern   string
    CultureInfo       CultureName
}

MaxCalcIterations 는 반복 계산을 위한 최대 반복을 지정하며 기본값은 0 입니다.

Password 는 스프레드시트의 비밀번호를 일반 텍스트로 지정합니다.

RawCellValue 는 셀 값에 숫자 형식을 적용할지 아니면 원시 값을 가져올지 지정합니다.

UnzipSizeLimit 은 스프레드시트를 열 때 압축 해제 크기 제한을 바이트 단위로 지정합니다. 이 값은 UnzipXMLSizeLimit 이상이어야 하며 기본 크기 제한은 16GB 입니다.

UnzipXMLSizeLimit 은 압축 해제 워크시트 및 공유 문자열 테이블의 메모리 제한을 바이트 단위로 지정합니다. 파일 크기가 이 값을 초과하면 워크시트 XML이 시스템 임시 디렉토리로 추출됩니다. 이 값은 기본값인 UnzipSizeLimit 보다 작거나 같아야 합니다. 값은 16MB 입니다.

ShortDatePattern 은 간단한 날짜 숫자 형식 코드를 지정합니다. 스프레드시트 애플리케이션에서 날짜 형식은 날짜 및 시간 일련 번호를 날짜 값으로 표시합니다. 별표 (*) 로 시작하는 날짜 형식은 운영 체제에 지정된 지역 날짜 및 시간 설정의 변경 사항에 응답합니다. 별표가 없는 형식은 운영 체제 설정의 영향을 받지 않습니다. 별표로 시작하는 적용 날짜 형식을 지정하는 데 사용되는 ShortDatePattern 입니다.

LongDatePattern 은 긴 날짜 숫자 형식 코드를 지정합니다.

LongTimePattern 은 긴 시간 숫자 형식 코드를 지정합니다.

CultureInfo 는 시스템의 현지 언어 설정에 따른 영향을 받는 내장 언어 번호 형식 코드를 적용하기 위한 국가 코드를 지정합니다.

Excel 문서 만들기

func NewFile(opts ...Options) *File

NewFile 을 사용 하 여 새 Excel 통합 문서를 만들고 새로 만든 통합 문서에는 기본적으로 Sheet1 이라는 워크시트가 포함 됩니다.

열기

func OpenFile(filename string, opts ...Options) (*File, error)

OpenFile 을 사용 하 여 기존 Excel 문서를 엽니다. 예를 들어, 암호로 보호 된 스프레드 시트를 엽니 다:

f, err := excelize.OpenFile("Book1.xlsx", excelize.Options{Password: "password"})
if err != nil {
    return
}

스프레드시트를 연 후 Close() 로 파일을 닫습니다.

열린 데이터 스트림

func OpenReader(r io.Reader, opts ...Options) (*File, error)

OpenReader 는 io.Reader 에서 데이터 스트림을 읽고 채워진 스프레드 시트 파일을 반환합니다.

예를 들어, 업로드 템플리트를 처리 할 HTTP 서버를 작성한 후 새 워크 시트가 추가 된 응답 다운로드 파일:

package main

import (
    "fmt"
    "net/http"

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

func process(w http.ResponseWriter, req *http.Request) {
    file, _, err := req.FormFile("file")
    if err != nil {
        fmt.Fprint(w, err.Error())
        return
    }
    defer file.Close()
    f, err := excelize.OpenReader(file)
    if err != nil {
        fmt.Fprint(w, err.Error())
        return
    }
    f.Path = "Book1.xlsx"
    f.NewSheet("NewSheet")
    w.Header().Set("Content-Disposition", fmt.Sprintf("attachment; filename=%s", f.Path))
    w.Header().Set("Content-Type", req.Header.Get("Content-Type"))
    if err := f.Write(w); err != nil {
        fmt.Fprint(w, err.Error())
    }
}

func main() {
    http.HandleFunc("/process", process)
    http.ListenAndServe(":8090", nil)
}

cURL 로 테스트:

curl --location --request GET 'http://127.0.0.1:8090/process' \
--form 'file=@/tmp/template.xltx' -O -J

저장

func (f *File) Save(opts ...Options) error

Save 을 사용 하 여 Excel 문서에 대 한 편집 내용을 저장 합니다.

다른 이름으로 저장

func (f *File) SaveAs(name string, opts ...Options) error

Excel 문서를 지정 된 파일로 저장 하려면 SaveAs 를 사용 하십시오.

통합 문서 닫기

func (f *File) Close() error

Close 는 스프레드시트에 대해 열려 있는 임시 파일을 닫고 정리합니다.

워크 시트 만들기

func (f *File) NewSheet(sheet string) (int, error)

NewSheet 는 워크 시트 이름을 지정하여 새 시트를 만드는 기능을 제공하고 추가 된 후 통합 문서 (스프레드 시트)의 시트 인덱스를 반환합니다. 새 스프레드 시트 파일을 만들 때 Sheet1 이라는 기본 워크 시트가 생성됩니다.

워크 시트 삭제

func (f *File) DeleteSheet(sheet string) error

DeleteSheet 는 지정된 워크 시트 이름으로 통합 문서의 워크 시트를 삭제하는 기능을 제공하며 시트 이름은 대/소문자를 구분하지 않습니다. 이 방법은 수식, 차트 등과 같은 참조의 변경에 영향을 주는 주의해서 사용하십시오. 삭제된 워크시트의 참조된 값이 있으면 워크시트를 열 때 파일 오류가 발생합니다. 이 함수는 워크시트가 하나만 남아 있으면 유효하지 않습니다.

워크 시트 복사

func (f *File) CopySheet(from, to int) error

대상 워크시트 인덱스에는 지정 된 복사 된 워크시트와 워크시트를 복사 하는 대상 워크시트 인덱스에 따라 개발자가 이미 존재 하는지 확인 해야 합니다. 셀 값과 수식이 포함 된 워크시트 간의 복제는 현재 지원 되며 테이블, 그림, 차트 및 피벗 테이블과 같은 요소를 포함 하는 워크시트 간의 복제를 지원 하지 않습니다.

// Sheet1 이름이 있는 워크시트가 이미 있습니다 ...
index, err := f.NewSheet("Sheet2")
if err != nil {
    fmt.Println(err)
    return
}
err := f.CopySheet(1, index)

그룹 워크시트

func (f *File) GroupSheets(sheets []string) error

GroupSheets 는 주어진 워크시트 이름으로 워크시트를 그룹화하는 기능을 제공합니다. 그룹 워크시트에는 활성 워크시트가 있어야 합니다.

워크시트 그룹 해제

func (f *File) UngroupSheets() error

UngroupSheets 는 워크시트를 그룹 해제하는 기능을 제공합니다.

워크 시트 배경

func (f *File) SetSheetBackground(sheet, picture string) error

SetSheetBackground 는 주어진 워크시트 이름과 파일 경로로 배경 그림을 설정하는 기능을 제공합니다. 지원되는 이미지 유형: BMP, EMF, EMZ, GIF, JPEG, JPG, PNG, SVG, TIF, TIFF, WMF 및 WMZ.

func (f *File) SetSheetBackgroundFromBytes(sheet, extension string, picture []byte) error

SetSheetBackgroundFromBytes 는 주어진 워크시트 이름, 확장자 이름 및 이미지 데이터로 배경 그림을 설정하는 기능을 제공합니다. 지원되는 이미지 유형: BMP, EMF, EMZ, GIF, JPEG, JPG, PNG, SVG, TIF, TIFF, WMF 및 WMZ.

기본 워크 시트 설정

func (f *File) SetActiveSheet(index int)

SetActiveSheet 는 지정된 인덱스로 통합 문서의 기본 활성 시트를 설정하는 기능을 제공합니다. 활성 인덱스는 GetSheetMap 함수가 리턴 한 ID와 다릅니다. 총 워크 시트 수보다 0 보다 크거나 같아야합니다.

활성 시트 색인 가져 오기

func (f *File) GetActiveSheetIndex() int

기본 워크시트의 인덱스를 가져오고 기본 워크시트를 찾을 수 없는 경우 0 을 반환 합니다.

워크 시트 가시성 설정

func (f *File) SetSheetVisible(sheet string, visible bool, veryHidden ...bool) error

SetSheetVisible 은 지정된 워크 시트 이름으로 표시되는 워크 시트를 설정하는 함수를 제공합니다. 통합 문서에는 최소한 하나의 보이는 워크 시트가 있어야합니다. 지정된 워크 시트가 활성화 된 경우이 설정은 무효화됩니다. 세 번째 선택적 veryHidden 매개변수는 visible 이 false 인 경우에만 작동합니다.

예를 들어,Sheet1 을 숨 깁니다.

err := f.SetSheetVisible("Sheet1", false)

워크 시트 가시성 확보

func (f *File) GetSheetVisible(sheet string) (bool, error)

GetSheetVisible 은 주어진 워크 시트 이름으로 볼 수있는 워크 시트를 가져 오는 기능을 제공합니다. 예를 들어, Sheet1 의 표시 상태 가져 오기:

visible, err := f.GetSheetVisible("Sheet1")

워크 시트 속성 설정

func (f *File) SetSheetProps(sheet string, opts *SheetPropsOptions) error

SetSheetProps 는 워크시트 속성을 설정하는 함수를 제공합니다. 설정할 수 있는 속성은 다음과 같습니다:

예를 들어, 워크 시트 행을 기본적으로 숨김으로 설정하십시오:

f, enable := excelize.NewFile(), true
if err := f.SetSheetProps("Sheet1", &excelize.SheetPropsOptions{
    ZeroHeight: &enable,
}); err != nil {
    fmt.Println(err)
}
if err := f.SetRowVisible("Sheet1", 10, true); err != nil {
    fmt.Println(err)
}
f.SaveAs("Book1.xlsx")

워크 시트 속성 가져 오기

func (f *File) GetSheetProps(sheet string) (SheetPropsOptions, error)

GetSheetProps 는 워크시트 속성을 가져오는 함수를 제공합니다.

워크 시트보기 속성 설정

func (f *File) SetSheetView(sheet string, viewIndex int, opts *ViewOptions) error

SetSheetView 는 시트 뷰 속성을 설정합니다. viewIndex 는 음수 일 수 있으며 그렇다면 뒤로 계산됩니다 (-1 은 마지막 뷰입니다). 설정할 수 있는 속성은 다음과 같습니다:

워크 시트 뷰 속성 가져 오기

func (f *File) GetSheetView(sheet string, viewIndex int) (ViewOptions, error)

GetSheetView 는 시트 뷰 속성의 값을 가져옵니다. viewIndex 는 음수 일 수 있으며 그렇다면 뒤로 계산됩니다 (-1 은 마지막 뷰입니다).

워크 시트 페이지 레이아웃 설정

func (f *File) SetPageLayout(sheet string, opts *PageLayoutOptions) error

지정 된 워크시트 이름 및 페이지 레이아웃 매개 변수를 기반으로 워크시트의 페이지 레이아웃 속성을 설정 합니다. 현재 설정에 대해 지원 되는 페이지 레이아웃 속성:

Size 방법을 사용 하 여 페이지 용지의 크기를 설정 합니다, 기본 페이지 레이아웃 크기는 "Letter paper (8.5 in. by 11 in.)" 입니다. 다음 표는 excel에서 페이지 레이아웃 크기와 인덱스 Size 매개 변수를 비교한 것입니다:

Orientation 은 워크시트 방향을 지정했으며 기본 방향은 portrait 입니다. 이 필드에 사용할 수 있는 값은 portrait 와 landscape 입니다.

FirstPageNumber 는 첫 번째 인쇄된 페이지 번호를 지정했습니다. 값을 지정하지 않으면 "자동" 으로 간주됩니다.

AdjustTo 는 인쇄 배율을 지정했습니다. 이 속성은 10(10%) 에서 400(400%) 사이의 값으로 제한됩니다. 이 설정은 FitToWidth 및/또는 FitToHeight 를 사용 중일 때 재정의됩니다.

FitToHeight 는 맞출 세로 페이지 수를 지정했습니다.

FitToWidth 는 맞출 가로 페이지의 수를 지정했습니다.

BlackAndWhite 는 흑백으로 인쇄를 지정했습니다.

예를 들어 Sheet1 이라는 시트 페이지 레이아웃을 단색 인쇄로 설정하고, 시작 페이지 번호를 2 로 설정하고, 가로로, A4(작은) 210× 297mm 용지 사용, 2 세로 페이지에 맞게 조정하고 2 개의 가로 페이지를 맞출 수 있습니다:

f := excelize.NewFile()
var (
    size                 = 10
    orientation          = "landscape"
    firstPageNumber uint = 2
    adjustTo        uint = 100
    fitToHeight          = 2
    fitToWidth           = 2
    blackAndWhite        = true
)
if err := f.SetPageLayout("Sheet1", &excelize.PageLayoutOptions{
    Size:            &size,
    Orientation:     &orientation,
    FirstPageNumber: &firstPageNumber,
    AdjustTo:        &adjustTo,
    FitToHeight:     &fitToHeight,
    FitToWidth:      &fitToWidth,
    BlackAndWhite:   &blackAndWhite,
}); err != nil {
    fmt.Println(err)
}

워크 시트 페이지 레이아웃 가져 오기

func (f *File) GetPageLayout(sheet string) (PageLayoutOptions, error)

GetPageLayout 은 워크시트 페이지 레이아웃을 가져오는 함수를 제공합니다.

워크 시트 페이지 여백 설정

func (f *File) SetPageMargins(sheet string, opts *PageLayoutMarginsOptions) error

SetPageMargins 는 워크 시트 페이지 여백을 설정하는 기능을 제공합니다. 사용 가능한 옵션:

워크 시트 페이지 여백 가져 오기

func (f *File) GetPageMargins(sheet string) (PageLayoutMarginsOptions, error)

GetPageMargins 는 워크 시트 페이지 여백을 얻는 기능을 제공합니다.

통합 문서 속성 설정

func (f *File) SetWorkbookProps(opts *WorkbookPropsOptions) error

SetWorkbookProps 는 통합 문서 속성을 설정하는 기능을 제공합니다. 사용 가능한 옵션:

통합 문서 속성 가져오기

func (f *File) GetWorkbookProps() (WorkbookPropsOptions, error)

GetWorkbookProps 는 통합 문서 속성을 가져오는 기능을 제공합니다.

머리글 및 바닥 글 설정

func (f *File) SetHeaderFooter(sheet string, opts *HeaderFooterOptions) error

SetHeaderFooter 는 주어진 워크 시트 이름과 제어 문자로 머리글과 바닥 글을 설정하는 기능을 제공합니다.

머리글과 바닥 글은 다음 설정 필드를 사용하여 지정됩니다.

다음 형식 코드는 6 개의 문자열 형식 필드에서 사용할 수 있습니다: OddHeader, OddFooter, EvenHeader, EvenFooter, FirstFooter, FirstHeader

예:

err := f.SetHeaderFooter("Sheet1", &excelize.HeaderFooterOptions{
    DifferentFirst:   true,
    DifferentOddEven: true,
    OddHeader:        "&R&P",
    OddFooter:        "&C&F",
    EvenHeader:       "&L&P",
    EvenFooter:       "&L&D&R&T",
    FirstHeader:      `&CCenter &"-,Bold"Bold&"-,Regular"HeaderU+000A&D`,
})

이 예는 다음과 같습니다:

• 첫 페이지에는 고유 한 머리말과 꼬리말이 있습니다.
• 홀수 페이지와 짝수 페이지는 서로 다른 머리글과 바닥 글을 가지고 있습니다.
• 홀수 페이지 헤더의 오른쪽 섹션에있는 현재 페이지 번호 홀수 페이지 바닥 글의 가운데 섹션에있는 현재 통합 문서의 파일 이름
• 짝수 페이지 헤더의 왼쪽 섹션에있는 현재 페이지 번호
• 왼쪽 섹션의 현재 날짜와 짝수 페이지 바닥 글의 오른쪽 섹션의 현재 시간
• 첫 번째 페이지의 가운데 섹션의 첫 번째 줄에있는 텍스트 "Center Bold Header"과 같은 페이지의 가운데 섹션의 두 번째 줄에있는 날짜
• 첫 페이지에 꼬리말 없음

이름 설정

func (f *File) SetDefinedName(definedName *DefinedName) error

지정된 이름과 범위를 기반으로 이름을 설정합니다. 기본 범위는 통합 문서입니다. 예:

err := f.SetDefinedName(&excelize.DefinedName{
    Name:     "Amount",
    RefersTo: "Sheet1!$A$2:$D$5",
    Comment:  "defined name comment",
    Scope:    "Sheet2",
})

워크 시트의 인쇄 영역 및 인쇄 제목 설정:

if err := f.SetDefinedName(&excelize.DefinedName{
    Name:     "_xlnm.Print_Area",
    RefersTo: "Sheet1!$A$1:$Z$100",
    Scope:    "Sheet1",
}); err != nil {
    fmt.Println(err)
}
if err := f.SetDefinedName(&excelize.DefinedName{
    Name:     "_xlnm.Print_Titles",
    RefersTo: "Sheet1!$A:$A,Sheet1!$1:$1",
    Scope:    "Sheet1",
}); err != nil {
    fmt.Println(err)
}

이름 가져 오기

func (f *File) GetDefinedName() []DefinedName

범위에있는 통합 문서 및 워크 시트의 이름 목록을 얻습니다.

정의 된 이름 삭제

func (f *File) DeleteDefinedName(definedName *DefinedName) error

DeleteDefinedName 은 통합 문서 또는 워크 시트의 정의 된 이름을 삭제하는 기능을 제공합니다. 범위를 지정하지 않으면 기본 범위는 통합 문서입니다. 예를 들면 다음과 같습니다:

err := f.DeleteDefinedName(&excelize.DefinedName{
    Name:     "Amount",
    Scope:    "Sheet2",
})

애플리케이션 속성 설정

func (f *File) SetAppProps(appProperties *AppProperties) error

SetAppProps 는 문서 애플리케이션 속성을 설정하는 기능을 제공합니다. 설정할 수 있는 속성은 다음과 같습니다.

예:

err := f.SetAppProps(&excelize.AppProperties{
    Application:       "Microsoft Excel",
    ScaleCrop:         true,
    DocSecurity:       3,
    Company:           "Company Name",
    LinksUpToDate:     true,
    HyperlinksChanged: true,
    AppVersion:        "16.0000",
})

애플리케이션 속성 가져오기

func (f *File) GetAppProps() (*AppProperties, error)

GetAppProps 는 문서 응용 프로그램 속성을 가져오는 기능을 제공합니다.

문서 속성 설정

func (f *File) SetDocProps(docProperties *DocProperties) error

통합 문서의 핵심 속성을 설정합니다. 설정할 수있는 속성은 다음과 같습니다:

예:

err := f.SetDocProps(&excelize.DocProperties{
    Category:       "category",
    ContentStatus:  "Draft",
    Created:        "2019-06-04T22:00:10Z",
    Creator:        "Go Excelize",
    Description:    "This file created by Go Excelize",
    Identifier:     "xlsx",
    Keywords:       "Spreadsheet",
    LastModifiedBy: "Go Author",
    Modified:       "2019-06-04T22:00:10Z",
    Revision:       "0",
    Subject:        "Test Subject",
    Title:          "Test Title",
    Language:       "en-US",
    Version:        "1.0.0",
})

문서 속성 가져오기

func (f *File) GetDocProps() (*DocProperties, error)

통합 문서의 핵심 속성을 가져옵니다.

통합 문서 보호

func (f *File) ProtectWorkbook(opts *WorkbookProtectionOptions) error

ProtectWorkbook 은 다른 사용자가 실수로 또는 의도적으로 통합 문서의 데이터를 변경, 이동 또는 삭제하는 것을 방지하는 기능을 제공합니다. 선택 필드 AlgorithmName 은 해시 알고리즘을 지정했으며 현재 XOR, MD4, MD5, SHA-1, SHA2-56, SHA-384 및 SHA-512 를 지원하며 해시 알고리즘이 지정되지 않은 경우 XOR 알고리즘을 기본값으로 사용합니다. 예를 들어 보호 설정으로 통합 문서를 보호합니다:

err := f.ProtectWorkbook(&excelize.WorkbookProtectionOptions{
    Password:      "password",
    LockStructure: true,
})

WorkbookProtectionOptions 는 통합 문서 보호 설정을 직접 매핑합니다.

type WorkbookProtectionOptions struct {
    AlgorithmName string
    Password      string
    LockStructure bool
    LockWindows   bool
}

통합 문서 보호 해제

func (f *File) UnprotectWorkbook(password ...string) error

UnprotectWorkbook 은 통합 문서에 대한 보호를 제거하는 기능을 제공하며 암호 확인을 통해 통합 문서 보호를 제거하기 위해 선택적 암호 매개 변수를 지정합니다.