TDateTime - Mad.Builder

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

__construct

Construtor da classe TDateTime. Parâmetros:

mixed

required

Nome do widget.

Exemplo de código:

$dataHora = new TDateTime('dataHora');

setValue

Armazena o valor no objeto. Parâmetros:

mixed

required

Valor da data e hora.

Exemplo de código:

$dataHora = new TDateTime('dataHora');
$dataHora->setValue('2021-01-01 00:00');

setMask

Define a máscara do campo. Parâmetros:

mixed

required

Máscara para os dados de entrada.

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:

$dataHora = new TDateTime('dataHora');
$dataHora->setMask('dd/mm/yyyy hh:ii');

setDatabaseMask

Define a máscara do banco de dados. Parâmetros:

mixed

required

Máscara para a base de dados.

Exemplo de código:

$dataHora = new TDateTime('dataHora');
$dataHora->setDatabaseMask('yyyy/mm/dd hh:ii:ss');

Obs.: perceba que, ao executar o código acima, a máscara presente em nível de aplicação não terá sido alterada.

setOption

Define opções adicionais do datepicker. Parâmetros:

mixed

required

Nome da opção.

mixed

required

Valor da opção.

Exemplo de código:

$dataHora = new TDateTime('dataHora');
$dataHora->setOption('todayHighlight', false);

setExitAction

Define a ação a ser executada quando o usuário sai do campo. Parâmetros:

TAction

required

Objeto TAction.

Exemplo de código:

$dataHora = new TAction('dataHora');
$dataHora->setExitAction(['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 altera o campo. Parâmetros:

TAction

required

Objeto TAction.

Exemplo de código:

$dataHora = new TAction('dataHora);
$dataHora->setChangeAction(['NomeClasseDeControle', 'onDateTimeChange']);

Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function).

public static function onDateTimeChange($param = null)
{
    new TMessage('info', 'Data e hora foram alteradas com sucesso!');
}

setChangeFunction

Define uma função JavaScript a ser executada quando o usuário alterar o campo Parâmetros:

mixed

required

Função JavaScript.

Exemplo de código:

$dataHora = new TDateTime('dataHora');
$dataHora->setChangeFunction('alert("Data e/ou hora alterada.");');

getPostData

Retorna os dados postados (transformará valores de acordo com a máscara do banco de dados). Exemplo de código:

$dataHora = new TDateTime('dataHora');
$dadosPostados = $dataHora->getPostData();

convertToMask

(Método estático) Converte uma data de uma máscara para outra. Parâmetros:

mixed

required

Data original.

mixed

required

Máscara de origem.

mixed

required

Máscara de destino.

Exemplo de código:

$dataHora = new TDateTime('dataHoraNascimento');
$dataHora->setMask('dd/mm/yyyy hh:ii');
$dataHora->setValue('03/10/2025 15:30');

$dataHoraUs = TDateTime::convertToMask($dataHora->getValue(), $dataHora->getMask(), 'yyyy-mm-dd hh:ii');
echo $dataHoraUs; // 2025-10-03 15:30

enableField e disableField

(Método estático) Habilita ou desabilita um campo de data e hora no formulário. Parâmetros:

mixed

required

Nome do formulário.

mixed

required

Nome do formulário.

Exemplo de código:

$dataHora = new TDateTime('dataHora');
$dataHora->setValue(date('d/m/Y h:i'));

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

$btnDesabilitar = new TButton('btnDisableField');
$btnDesabilitar->addStyleClass('btn-default');
$btnDesabilitar->setImage('far:circle #000000');
$btnDesabilitar->setAction(new TAction([$this, 'desabilitarCampo']), 'Desabilitar Campo');

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)
{
    TDateTime::enableField('nomeForm', 'dataHora');
}

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

​__construct

​setValue

​setMask

​setDatabaseMask

​setOption

​setExitAction

​setChangeAction

​setChangeFunction

​getPostData

​convertToMask

​enableField e disableField

__construct

setValue

setMask

setDatabaseMask

setOption

setExitAction

setChangeAction

setChangeFunction

getPostData

convertToMask

enableField e disableField