method AddFmt

AddFmt

:AddFmt(cformatCode,nNumFmtId)
Cria um formato de número personalizado ou altera um existente. O id retornado é usado no SetnumFmt do NewStyle.

---

Parâmetros

Parâmetro	Tipo	Descrição	Obrigatório	Obs
cformatCode	caractere	Código do formato personalizado (sintaxe de formato do Excel)	X
nNumFmtId	numérico	numFmtId de um formato existente para alteração		Se omitido, cria um novo

Retorno

Numérico - numFmtId do formato criado/alterado

Exemplo

Local oExcel := custom.excel.Xlsx():New(cNomeFile="TstYExcel",cTipo="A")
oExcel:ADDPlan()
//Data no formato mês-ano
oExcel:Pos(1,1):SetValue(date()):SetStyle(oExcel:NewStyle():SetnumFmt(oExcel:AddFmt("[$-pt-BR]mmm-aaa;@")))
//Hora no formato hh:mm:ss
oExcel:Pos(1,2):SetDateTime(dDate=CTOD(""),cTime="10:30:00"):SetStyle(oExcel:NewStyle():SetnumFmt(oExcel:AddFmt("hh:mm:ss;@")))
oExcel:Save(GetTempPath())
oExcel:OpenApp()
oExcel:Close()

Obs

Para formatos numéricos comuns (decimais, milhar, prefixo, cores) utilize o gerador AddFmtNum, que monta o formatCode automaticamente.
Formatos padrão do Excel também podem ser usados diretamente pelo id (ex: 44 = moeda contábil) sem precisar do AddFmt.