Skip to main content
Derivado da classe TEntry, métodos herdados não sobrescritos podem também ser utililzados por objetos TDate. Acesse a documentação do componente/classe-pai para conhecê-los.

​
__construct

Construtor da classe TDate. Parâmetros:
​
$name
mixed
required
Nome do widget.
 Exemplo de código: 
$dataNascimento = new TDate('dataNascimento');

​
setValue

Armazena o valor dentro do objeto. Parâmetros:
​
$value
mixed
required
Valor a ser definido.
 Exemplo de código: 
$dataNascimento = new TDate('dataNascimento');
$dataNascimento->setValue('2023-05-10');

​
setMask

Define a máscara do campo. Parâmetros:
​
$mask
mixed
required
Máscara para os dados de entrada.
​
$replaceOnPost
bool
default:"false"
(Opcional) Booleano indicando se a máscara deve ser substituída após o envio do formulário.
 Exemplo de código: 
$dataNascimento = new TDate('dataNascimento');
$dataNascimento->setMask('dd/mm/yyyy');

​
getMask

Retorna a máscara atual do campo. Exemplo de código: 
$dataNascimento = new TDate('dataNascimento');
$dataNascimento->setMask('mm/dd/yyyy');
$mask = $dataNascimento->getMask(); // mm/dd/yyyy

​
setDatabaseMask

Define a máscara do banco de dados para coleta dos dados. Parâmetros:
​
$mask
mixed
required
Máscara para os dados.
 Exemplo de código: 
$dataNascimento = new TDate('dataNascimento');
$dataNascimento->setDatabaseMask('mm/dd/yyyy');
Obs.: perceba que, ao executar o código acima, a máscara presente em nível de aplicação não terá sido alterada.

​
getDatabaseMask

Retorna a máscara do banco de dados. Exemplo de código: 
$dataNascimento = new TDate('dataNascimento');
$dataNascimento->setDatabaseMask('yyyy-mm-dd');
$dbMask = $dataNascimento->getDatabaseMask(); // yyyy-mm-dd

​
setOption

Define opções extras do datepicker. Parâmetros:
​
$option
mixed
required
Opção a ser definida.
​
$value
mixed
required
Valor da opção.
 Exemplo de código: 
$dataNascimento = new TDate('dataNascimento');
$dataNascimento->setOption('calendarWeeks', true);

​
setExitAction

Define a ação a ser executada quando o usuário altera o valor do campo. Parâmetros:
​
$action
TAction
required
Objeto TAction.
 Exemplo de código: 
$dataEvento = new TDate('dataEvento');
$dataEvento->setExitAction(new TAction(['NomeClasseDeControle', 'onExitCampo']));
Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function). 
public static function onExitCampo($param = null)
{
    new TMessage('info', print_r($param, true));
}

​
setChangeAction

Define a ação a ser executada quando o usuário alterar o campo. Parâmetros:
​
$action
TAction
required
Objeto TAction.
 Exemplo de código: 
$dataNascimento = new TDate('dataNascimento');
$dataNascimento->setChangeAction(new TAction(['NomeClasseDeControle', 'onDateChange']));
Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function). 
public static function onDateChange($param = null)
{
    new TMessage('info', 'A data foi alterada com sucesso!');
}

​
setChangeFunction

Define a função JavaScript a ser executada quando o usuário alterar o campo. Parâmetros:
​
$function
mixed
required
Função JavaScript.
 Exemplo de código: 
$dataNascimento = new TDate('dataNascimento');
$dataNascimento->setChangeFunction('alert("Data alterada.");');

​
getPostData

Retorna o dado enviado pelo formulário (transformará valores de acordo com a máscara do banco de dados). Exemplo de código: 
$dataNascimento = new TDate('dataNascimento');
$dataNascimento->setMask('mm/dd/yyyy');

$dadosPostados = $dataNascimento->getPostData();

​
convertToMask

(Método estático) Converte uma data de uma máscara para outra. Parâmetros:
​
$value
mixed
required
Data original.
​
$fromMask
mixed
required
Máscara de origem.
​
$toMask
mixed
required
Máscara de destino.
 Exemplo de código: 
$data = new TDate('dataNascimento');
$data->setMask('dd/mm/yyyy');
$data->setValue('03/10/2025');

$dataUs = TDate::convertToMask($data->getValue(), $data->getMask(), 'yyyy-mm-dd');
echo $dataUs; // 2025-10-03

​
date2us

(Método estático) Converte uma data do formato dd/mm/yyyy para yyyy-mm-dd. Parâmetros:
​
$date
mixed
required
Data em formato dd/mm/yyyy.
 Exemplo de código: 
echo TDate::date2us('20/05/2023'); // 2023-05-20

​
date2br

(Método estático) Converte uma data do formato yyyy-mm-dd para dd/mm/yyyy. Parâmetros:
​
$date
mixed
required
Data em formato yyyy-mm-dd.
 Exemplo de código: 
echo TDate::date2br('2023-05-20'); // 20/05/2023

​
enableField e disableField

(Método estático) Habilita ou desabilita um campo de data no formulário. Parâmetros:
​
$form_name
mixed
required
Nome do formulário.
​
$field
mixed
required
Nome do campo.
 Exemplo de código: 
$data = new TDate('data');
$data->setValue(date('d/m/Y'));

$btnHabilitar = new TButton('btnEnableField');
$btnHabilitar->addStyleClass('btn-default');
$btnHabilitar->setImage('far:circle #000000');
$btnHabilitar->setAction(new TAction([$this, 'habilitarCampo']), 'Habilitar Campo de Data');

$btnDesabilitar = new TButton('btnDisableField');
$btnDesabilitar->addStyleClass('btn-default');
$btnDesabilitar->setImage('far:circle #000000');
$btnDesabilitar->setAction(new TAction([$this, 'desabilitarCampo']), 'Desabilitar Campo de Data');
Código de exemplo das funções a serem chamadas, lembrando que essas funções precisam ser estáticas (static function). 
public static function habilitarCampo($param = null)
{
    TDate::enableField('nomeForm', 'data');
}

public static function desabilitarCampo($param = null)
{
    TDate::disableField('nomeForm', 'data');
}