# j-Period

> O componente para escolher um período de tempo.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: pt
Content-SHA256: a1622b6530ab83bc8acb43dd2d0a544b2e26c86cf9de695168e4539d4c34ad12
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

O componente para escolher um período de tempo.

- Singularidade

__Métodos__:

Método: `component.show(options)`

- `options.element` {Elemento/jQuery Elemento} - todos os cálculos de alligamento serão relativos a este elemento
- `options.align` Alinear o componente relativamente ao elemento na propriedade `options.element`. Propriedades disponíveis: 'centro', 'direita' e 'direito'.
- `options.callback` Função, que será executada clicando no botão 'Aplique' do componente - recebe dois parâmetros: início e fim de data objetos
- `options.start`, `options.end` {Data} - Para predefinir o período selecionado, **ambas** dessas propriedades devem ser especificadas.


__Configuração__:

- `firstday` - {String} - Permite definir o primeiro dia da semana para segunda-feira.O valor padrão é 'Montês' - Dias da semana começam a partir de segunda-dia.
- `dateformat` - {String} - especifica o formato de data. o valor padrão - `DEF.dateformat`
- `apply` - {String} - Etiqueta para o botão "Aplique"
- `cancel` - {String} - Etiqueta para o botão "Cancelar"
- `custom` - {String} - Etiqueta para o botão de filtro "Custom"
- `month` - {String} - Etiqueta para "Mês atual" botão de filtro
- `thisY` - {String} - Etiqueta para "Este ano" botão de filtro
- `lastY` - {String} - Etiqueta para "último ano" botão de filtro

Use-o com `<ui-component name="period">`Quando o componente ainda não está carregado, jComponent Descarrega-o no primeiro uso do endereço `DEF.fallback` (a partir do Componentator CDN por padrão). autor: Kirill Zlobin. fonte: o Componentator Reserva de componentes, licença MIT.

```html example.html
<ui-component name="LAZY period"></ui-component>

<button class="btn">Click</button>

<script>

    $(document).on('click', '.btn', function() {
        var opt = {};
        opt.element = $(this);
        opt.align = 'left';
        opt.callback = function(start, end) {
            console.log(start);
            console.log(end);
        };
        SETTER('period/show', opt);
    });


</script>
```