--- title: "Hora do dia" version: snapshot-2026-10-28 engineGeneration: astra-current language: C# status: source-reviewed reviewedAt: 2026-10-28 appRelease: "0.4.0-preview.20261028" runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-28/componentes/astra-render-time-of-day/ --- # Hora do dia Move o sol pela hora, data e latitude; dia, crepúsculo e noite **Família:** Luz · **Grupo:** Luzes · **Identificador:** `astra.render.time_of_day` · **Payload:** 2 :::note[Escopo da evidência] Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho. ::: ## Para que usar Gira o objeto da luz direcional pela hora, data e latitude, como um script de ciclo de dia da Unity. O céu procedural, a luz ambiente e a neblina acompanham o ângulo do sol; à noite uma Lua opcional vira a luz principal. Crie por + › Luzes › Sol com dia e noite (cria o Sol e a Lua já ligados) ou adicione a uma Luz direcional existente. Defina Hora, Latitude, Dia do ano e Norte. Duração do dia maior que zero faz a hora andar no Play. Em Lua, aponte outra Luz direcional para ela seguir a lua da mesma hora e data. ## Vindo de outra engine Na Godot, o conceito mais próximo está em [directionallight3d](https://docs.godotengine.org/en/4.5/classes/class_directionallight3d.html). A Astra estudou essa referência; os campos e o comportamento são os desta página, sem paridade garantida. Palavras que a busca de Adicionar componente aceita: `TimeOfDay`, `DayNight`, `Ciclo`, `dia`, `noite`, `Sol`, `Lua`, `Hora`. ## Criar e configurar Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Luz** / **Luzes** → **Hora do dia**. O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.TimeOfDay](/pt-br/snapshot-2026-10-28/api/astra-components-timeofday/). A rotação do transform muda de verdade e aparece no gizmo e no Inspector; quem escreve a rotação da luz por script disputa com a Hora do dia. Com duas direcionais, o céu usa a que tem Hora do dia. Fase da lua sai do dia do ano. No Play a hora avança no próprio componente; a hora escrita por script vale no quadro seguinte. **Guia relacionado:** [Dia e noite e a Lua](/pt-br/snapshot-2026-10-06/versoes/preview-0-4-0/#céu-luz-e-materiais) ## Exemplo de uso Com o Sol com dia e noite na Vila, ponha Hora 17,4: o horizonte fica avermelhado e as sombras compridas. Ponha 22: a Lua (0,5 lux, 12000 K) projeta a sombra e as estrelas giram com a hora. Para um dia de 24 minutos, Duração do dia 24. Para o ciclo inteiro ficar legível, troque o Volume para Exposição Automática. ## Dependências - [Luz](/pt-br/snapshot-2026-10-28/componentes/astra-render-light/): Adicione uma Luz direcional a este objeto: a hora do dia move o sol ## Conflitos Nenhuma regra adicional declarada no schema deste componente. ## Edição e ciclo de vida | Operação | Contrato | |---|---| | Adicionar/remover em Play | ponto seguro | | Alterar propriedades em Play | ponto seguro | | Múltiplas instâncias | Não | | Versão do payload | 2 | Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/). ## Propriedades Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto. ### Hora do dia | Propriedade | Tipo / unidade | Padrão | Domínio | |---|---|---|---| | [**Hora**](#field-hour)
`hour` | número · h | 10 | 0 … 24 | | [**Duração do dia**](#field-day-length-minutes)
`day_length_minutes` | número · min | 0 | 0 … 1440 | | [**Latitude**](#field-latitude)
`latitude` | número · ° | -15 | -90 … 90 | | [**Dia do ano**](#field-day-of-year)
`day_of_year` | número | 172 | 1 … 366 | | [**Norte**](#field-north-degrees)
`north_degrees` | número · ° | 0 | 0 … 360 | | [**Ativo**](#field-enabled)
`enabled` | booleano | verdadeiro | verdadeiro \| falso | | [**Lua**](#field-moon-light)
`moon_light` | referência | Nenhuma (noite sem luar) | astra.render.light |

Hora · hour

**Onde:** Inspector → **Hora do dia** → **Hora do dia** → **Hora**. **Uso e efeito:** Hora solar local; com Duração do dia, avança em Play **Valor:** 10 · **Tipo:** número · **Unidade:** h · **Domínio:** 0 … 24. Sol por hora, data e latitude, cor por elevação, céu procedural de dia, crepúsculo e noite e fase da lua pela data; sem luz direcional da lua nem eventos de nascer e pôr do sol Capacidade necessária: `render.environment.time_of_day`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

Duração do dia · day_length_minutes

**Onde:** Inspector → **Hora do dia** → **Hora do dia** → **Duração do dia**. **Uso e efeito:** Minutos reais para 24 h de jogo; 0 congela a hora **Valor:** 0 · **Tipo:** número · **Unidade:** min · **Domínio:** 0 … 1440. Sol por hora, data e latitude, cor por elevação, céu procedural de dia, crepúsculo e noite e fase da lua pela data; sem luz direcional da lua nem eventos de nascer e pôr do sol Capacidade necessária: `render.environment.time_of_day`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

Latitude · latitude

**Onde:** Inspector → **Hora do dia** → **Hora do dia** → **Latitude**. **Uso e efeito:** Altura do sol ao meio-dia e duração da noite; negativo no hemisfério sul **Valor:** -15 · **Tipo:** número · **Unidade:** ° · **Domínio:** -90 … 90. Sol por hora, data e latitude, cor por elevação, céu procedural de dia, crepúsculo e noite e fase da lua pela data; sem luz direcional da lua nem eventos de nascer e pôr do sol Capacidade necessária: `render.environment.time_of_day`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

Dia do ano · day_of_year

**Onde:** Inspector → **Hora do dia** → **Hora do dia** → **Dia do ano**. **Uso e efeito:** Estação e fase da lua; 172 é o solstício de junho **Valor:** 172 · **Tipo:** número · **Domínio:** 1 … 366. Sol por hora, data e latitude, cor por elevação, céu procedural de dia, crepúsculo e noite e fase da lua pela data; sem luz direcional da lua nem eventos de nascer e pôr do sol Capacidade necessária: `render.environment.time_of_day`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

Norte · north_degrees

**Onde:** Inspector → **Hora do dia** → **Hora do dia** → **Norte**. **Uso e efeito:** Gira o caminho do sol em torno do eixo vertical **Valor:** 0 · **Tipo:** número · **Unidade:** ° · **Domínio:** 0 … 360. Sol por hora, data e latitude, cor por elevação, céu procedural de dia, crepúsculo e noite e fase da lua pela data; sem luz direcional da lua nem eventos de nascer e pôr do sol Capacidade necessária: `render.environment.time_of_day`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/).

Ativo · enabled

**Onde:** Inspector → **Hora do dia** → **Hora do dia** → **Ativo**. **Uso e efeito:** Desligado, o componente para de agir e conserva os dados. **Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.

Lua · moon_light

**Onde:** Inspector → **Hora do dia** → **Hora do dia** → **Lua**. **Uso e efeito:** Luz direcional girada até a lua desta hora; à noite ilumina com a fase e projeta a sombra **Valor:** Nenhuma (noite sem luar) · **Tipo:** referência · **Domínio:** astra.render.light. Sol por hora, data e latitude, cor por elevação, céu procedural de dia, crepúsculo e noite e fase da lua pela data; sem luz direcional da lua nem eventos de nascer e pôr do sol Capacidade necessária: `render.environment.time_of_day`; veja [estado do renderer](/pt-br/snapshot-2026-10-06/roadmap/capacidades-do-renderer/). ## Roadmap deste componente [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Presente na 0.4.0. Eventos Hora mudou, Nascer do sol, Pôr do sol e Dia mudou na Conexão de evento e em C# (HourChanged, Sunrise, Sunset, DayChanged); Speed acelera o dia. Eclipses e refração atmosférica não existem. Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade. ## Conferir na sua cena 1. Crie **Hora do dia** pelo fluxo indicado e resolva as dependências. 2. Altere uma propriedade por vez e observe o efeito esperado na cena. 3. Salve, reabra e confira os valores autorais. 4. Entre em Play e verifique o comportamento com os recursos reais do projeto. 5. Pare o Play e confira a cena autoral. Este é um roteiro de conferência; não representa um teste executado nesta publicação. ## Limitações da referência A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas. **Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_directionallight3d.html). Essa referência não representa paridade funcional. ## Eventos do componente No Behavior, a fachada permite inscrever um receptor usando o owner vivo; a inscrição pertence ao lifecycle daquela execução. Uma Conexão de evento precisa de emissor, evento, receptor e ação: adicionar a conexão não define a regra do jogo. | Evento / ID | Quando ocorre | Dados enviados | |---|---|---| | **Hora mudou** · `hour_changed` | A hora inteira mudou: passou o tempo ou um script escreveu outra hora | Hora: inteiro (h) | | **Nascer do sol** · `sunrise` | O sol subiu acima do horizonte | Nenhum | | **Pôr do sol** · `sunset` | O sol desceu abaixo do horizonte | Nenhum | | **Dia mudou** · `day_changed` | A hora passou de 24 h; o Dia do ano avança um | Dia do ano: inteiro |