`num2ruler`

Converte valores numéricos para o tipo de dado usado por uma régua de eixo.

Categoria: Graphics > Formatting and Annotation

Sintaxe

data = num2ruler(num, ruler)

Converte os números num em valores do tipo exibido na régua, como datetime em um eixo de tempo.

Descrição

Eixos com dados datetime, duration ou categorical guardam as posições como números simples internamente. num2ruler traduz uma posição desse tipo de volta ao valor que o leitor vê no eixo, e ruler2num faz o caminho inverso.

Isso é útil quando uma propriedade, como um limite ou uma marca, é guardada numericamente mas o código precisa da data correspondente.

Argumentos de entrada

num: Array numérico de posições ao longo do eixo.
ruler: Uma régua de eixo, por exemplo ax.XAxis ou ax.YAxis.

Argumentos de saída

data: Valores no tipo da própria régua. Em uma régua numérica, são os mesmos números.

Exemplo

Posição em um eixo de datas

t = datetime(2024,1,1) + days(0:4);
plot(t, [1 4 2 5 3])
ax = gca;
n = ruler2num(t(3), ax.XAxis)
d = num2ruler(n, ax.XAxis)

Saída

n = 2
d = datetime
   03-Jan-2024

Observações

No MatLivre a conversão está disponível para réguas numéricas e de datetime. Outros tipos de régua não são convertidos.

Veja também

ruler2num datetime xlim xticks gca