method SetDateTime

SetDateTime

:SetDateTime(dDate,cTime)
Grava data e hora (DateTime) na célula posicionada

---

Parâmetros

Parâmetro	Tipo	Descrição	Obrigatório	Obs
dDate	data	Data a ser gravada		Default = CTOD("")
cTime	caractere	Hora a ser gravada no formato "HH:MM:SS"		Default = "00:00:00"

Retorno

Objeto - self (permite encadeamento de métodos)

Exemplo

Local oExcel := custom.excel.Xlsx():New(cNomeFile="TstYExcel",cTipo="A")
oExcel:ADDPlan()
oExcel:Pos(1,1):SetValue(date())                //Somente data
oExcel:Pos(1,2):SetDateTime(dDate=date(),cTime=time())      //Data e hora
//Somente hora, com formato personalizado
oExcel:Pos(1,3):SetDateTime(dDate=CTOD(""),cTime="00:00:01"):SetStyle(oExcel:NewStyle():SetnumFmt(oExcel:AddFmt("hh:mm:ss;@")))
//DateTime + 10 dias usando o objeto DateTime
oExcel:Pos(1,4):SetValue(oExcel:GetDateTime(dData=date(),cTime=time())+10)
oExcel:Save(GetTempPath())
oExcel:OpenApp()
oExcel:Close()

---

GetDateTime

:GetDateTime(dData,cTime,nData)
Retorna um objeto da classe custom.excel.DateTime para manipulação de data/hora. O objeto pode ser passado diretamente ao SetValue.

Parâmetros

Parâmetro	Tipo	Descrição	Obrigatório	Obs
dData	data	Data para formatação
cTime	caractere	Hora para formatação ("HH:MM:SS")
nData	numérico	DateTime no formato numérico do Excel		Alternativa a dData/cTime

Retorno

Objeto - instância de custom.excel.DateTime

Classe DateTime

Método/Operador	Descrição
GetDate()	Retorna a data (tipo Date)
GetTime()	Retorna a hora ("HH:MM:SS")
GetStrNumber()	Retorna o número do Excel como string
+ / -	Soma/subtrai dias do DateTime

Local oExcel := custom.excel.Xlsx():New(cNomeFile="TstYExcel",cTipo="A")
Local oDtHr  := oExcel:GetDateTime(dData=date(),cTime=time())
ConOut( DTOC(oDtHr:GetDate()) ) //Data
ConOut( oDtHr:GetTime() )       //Hora
oExcel:ADDPlan()
oExcel:Pos(1,1):SetValue(oDtHr+10) //Grava DateTime somando 10 dias
oExcel:Save(GetTempPath())
oExcel:OpenApp()
oExcel:Close()

Obs

Na leitura de células com data/hora utilize GetDtTime() após posicionar com Pos, que retorna um objeto DateTime.