> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.petto.sbs/llms.txt
> Use this file to discover all available pages before exploring further.

# Aniversários

> Os membros salvam o aniversário, e no dia o Petto publica uma mensagem na hora que você escolher e pode dar a eles um cargo pelo dia.

## Visão geral

Cada membro salva o próprio aniversário em um servidor com `!birthday set`. Nesse dia, o Petto envia uma mensagem no canal que você escolher, na hora que você escolher, e pode dar ao membro um **cargo pelo dia** (retirado um dia depois).

Salvar o aniversário é opcional para todos, e cada servidor tem a sua própria lista: um aniversário salvo em um servidor não aparece em outro.

![O Petto deseja feliz aniversário a for no #aniversarios, kira dá os parabéns e a mensagem recebe seis reações de bolo](https://mintcdn.com/wikipetto/LoL7QuPJ71yd9F_N/images/discord/community/pt-br/birthdays.webp?fit=max\&auto=format\&n=LoL7QuPJ71yd9F_N\&q=85\&s=f12f9bc5adf3444e0e975b0d69d11be4)

No Discord: o Petto comemora um aniversário no canal de aniversários com a mensagem padrão.

![Cargos do membro atualizados: for recebeu o cargo Aniversariante, dado pelo Petto](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-role-log.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=327dbbbcf2fd76a6c410bc4b72d8e220)

No Discord: o registro de membros quando o Petto dá o cargo do dia.

## Para os membros

```javascript Sintaxe theme={null}
!birthday set <day> <month> [year]
!birthday view [user]
!birthday upcoming
!birthday remove
```

```javascript Exemplo theme={null}
!birthday set 25 12
!birthday set 1 2 2007
!birthday view @Alguém
!birthday upcoming
```

* O **dia** vem primeiro, depois o mês. O ano é opcional: com ele, a mensagem pode dizer a idade que a pessoa completa (`{age}`).
* Só datas reais: não existe 30 de fevereiro. Um aniversário em **29 de fevereiro** é comemorado em 28 de fevereiro nos anos que não têm dia 29.
* `!birthday view` diz quantos dias faltam. `!birthday upcoming` lista os próximos do servidor (até 25). `!birthday remove` apaga o seu.
* Nomes curtos: `!bday` e `!bd`.

> [accordion] !birthday set
>
> ![mia.draws usa !birthday set 25 12 2006 e o Petto diz que o aniversário foi salvo: 25 de dezembro de 2006](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-set.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=00da2ae55dfc70c74a6d6c9a3b645015)
>
> No Discord: um aniversário salvo com o ano.

> [accordion] !birthday set (uma data que não existe)
>
> ![nico usa !birthday set 30 2 e o Petto responde que não existe o dia 30 de fevereiro](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-set-invalid.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=b23151d6081050bcc26dca3d1165d96f)
>
> No Discord: não existe 30 de fevereiro, então nada é salvo.

> [accordion] !birthday view
>
> ![kira usa !birthday view em mia.draws: 25 de dezembro de 2006, próximo aniversário em 57 dias, faz 20 anos](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-view.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=a83c3b5078ac721f43de054ca929b343)
>
> No Discord: o aniversário de um membro, os dias que faltam e a idade que vai fazer.

> [accordion] !birthday upcoming
>
> ![zoe\_plays usa !birthday upcoming e o Petto lista sete membros, for hoje com um bolo, nico amanhã e o resto em dias](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-upcoming.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=88c70a91f1b94dc4653338440fee8f82)
>
> No Discord: os próximos aniversários do servidor, o de hoje primeiro.

> [accordion] !birthday remove
>
> ![maxwell usa !birthday remove e o Petto responde que o aniversário foi apagado](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-remove.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=d63eab1ddab2bc05363c8fd669a2ad7b)
>
> No Discord: o Petto apaga o seu aniversário neste servidor.

## Para administradores

Tudo abaixo precisa de **Gerenciar servidor**. As mesmas configurações estão na página **Aniversários** do dashboard.

![A página Aniversários do Petto Land, ativa, com o canal de aniversários, o cargo Aniversariante, 9 horas em UTC-5 e a mensagem](https://mintcdn.com/wikipetto/PiFwt6dDUZHBNDT7/images/dashboard/community/pt-br/birthdays.webp?fit=max\&auto=format\&n=PiFwt6dDUZHBNDT7\&q=85\&s=103d93c5a98e005e893563a0404524ff)

Dashboard → Comunidade → Aniversários: as contagens, o canal, o cargo do dia, a hora, o fuso horário e a mensagem com a prévia.

```javascript Sintaxe theme={null}
!birthday config [enabled]
!birthday config --channel <channel> --role <role> --hour <0-23> --timezone <offset>
!birthday config --message <text> --embed <name>
!birthday config --clear_role true
```

```javascript Exemplo theme={null}
!birthday config true
!birthday config --channel #aniversários --hour 9 --timezone UTC-5
!birthday config --role @Aniversariante
!birthday config --message "Feliz aniversário, {user}! Você está fazendo {age}."
```

| Configuração | O que faz |
| - | - |
| `enabled` | Ativa ou desativa as mensagens de aniversário |
| `channel` | Onde a mensagem é enviada |
| `role` | Um cargo dado pelo dia. O Petto precisa estar acima dele |
| `hour` | A hora do dia em que ela é enviada (0 a 23), no fuso horário do servidor |
| `timezone` | O fuso horário do servidor como deslocamento: `UTC-5`, `-5`, `+5:30`. O padrão é UTC-5 |
| `message` | O texto. Use `none` para voltar ao padrão |
| `embed` | Um [embed salvo](https://wiki.petto.sbs/pt-br/resources/scripting/embeds.md) enviado no lugar do texto. Use `none` para deixar de usá-lo |

Sem nenhuma opção, `!birthday config` mostra as configurações atuais.

> [accordion] !birthday config
>
> ![liam usa !birthday config: mensagens ativadas, canal #aniversarios, cargo Aniversariante, enviada às 09:00 UTC-5 e a mensagem de sempre](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-config-view.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=2608245b7a1f69b7953a900fa6c6bd42)
>
> No Discord: as configurações atuais.

> [accordion] !birthday config --channel --hour --timezone
>
> ![liam escolhe o canal #aniversarios, a hora 9 e o fuso UTC-5, e o Petto mostra as configurações ainda sem cargo](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-config-channel.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=bc2da0a4c91905da2c6b5a37f8b57469)
>
> No Discord: o canal, a hora e o fuso horário em um comando; a resposta mostra todas as configurações.

> [accordion] !birthday config --role
>
> ![liam escolhe o cargo Aniversariante e as configurações agora o mostram como cargo do dia](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-config-role.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=72c4e59954e66ba295441ecc62414a33)
>
> No Discord: o cargo do dia.

> [accordion] !birthday config --message
>
> ![liam coloca a mensagem Feliz aniversário, \{user}! Você faz \{age}. e as configurações a mostram](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-config-message.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=23a81aa032865e30511ad8b29d6f72fc)
>
> No Discord: uma mensagem própria com \{age}.

> [accordion] Um fuso horário que o Petto não entende
>
> ![liam escreve --timezone Bogota e o Petto pede uma diferença como UTC-5, -5 ou +5:30](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-config-bad-timezone.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=42e7107a0705ff7c88821adf12965c90)
>
> No Discord: o fuso horário é uma diferença do UTC, não uma cidade.

> [accordion] Sem Gerenciar servidor
>
> ![nico usa !birthday config true e o Petto responde que é preciso a permissão Gerenciar servidor](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-config-no-permission.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=193e75e6fc180f08d8c4b741eecd31fa)
>
> No Discord: um membro sem Gerenciar servidor não pode mudar as configurações.

### Variáveis

O texto aceita `{user}`, `{user.mention}`, `{server}` e as outras [variáveis](https://wiki.petto.sbs/pt-br/resources/scripting/variables.md), preenchidas com o membro que faz aniversário. `{age}` é a idade que o membro completa (vazia quando ele não informou o ano) e funciona no texto, não em um embed salvo.

| Texto | O que aparece no canal |
| - | - |
| `🎂 Feliz aniversário, {user}! Hoje você faz {age}!` | 🎂 Feliz aniversário, @Liam! Hoje você faz 21! |
| `🎉 Todo mundo deseje feliz aniversário para {user.display_name}! {reactreply:🎂}` | 🎉 Todo mundo deseje feliz aniversário para Liam! (com uma reação 🎂) |
| `{choose:🎈\|🎁\|🥳} Hoje é o dia de {user} no {server_name}!` | 🥳 Hoje é o dia de @Liam no Cozy Corner! |

![o Petto publica em #aniversarios: Feliz aniversário, @ivy! Hoje você faz 18!, e chu parabeniza ivy](https://mintcdn.com/wikipetto/4M1nqnNiizNyXaId/images/discord/community/pt-br/birthdays-custom-message.webp?fit=max\&auto=format\&n=4M1nqnNiizNyXaId\&q=85\&s=d0520ad5122f34894c528e98108ad195)

No Discord: uma mensagem que o servidor escreveu, com \{age}, é enviada do jeito que está no dia.

Se você usar `{age}`, escreva a frase de um jeito que ainda fique boa sem ela, já que os membros que não informaram o ano não têm idade.

> [!TIP]
>
> As mensagens podem vir com nome e foto próprios: veja [Aparência das mensagens](https://wiki.petto.sbs/pt-br/setup/message-look.md), tipo `birthdays`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.