Модул
Съдържание
Индекс 🔎︎

# Функция TimeValue

Изчислява серийна стойност за час по зададени като низове час, минута и секунда. Стойността представя часа като едно единствено число. Тя може да се използва за изчисляване на разлики между часове.

## Синтаксис:

    TimeValue (Text As String)

## Връщана стойност:

Дата

## Параметри:

Text: низов израз, съдържащ часа във формат „ЧЧ:ММ:СС“.

С функцията TimeValue можете да преобразувате произволен точен час в числова стойност, за да изчислявате разлики между моменти във времето.

Функцията TimeValue връща стойност от типа Variant с VarType 7 (Date) и съхранява вътрешно стойността като число с двойна точност между 0 и 0,9999999999.

За разлика от функциите DateSerial и DateValue, при които серийните стойности за дати съответстват на относителен резултат в дни спрямо фиксирана дата, с резултатите от функцията TimeValue можете да извършвате изчисления, но не можете да ги преобразувате обратно.

При фукцията TimeSerial можете да подадете отделните параметри (час, минута и секунда) като отделни числови изрази. При TimeValue можете да подадете параметър низ, съдържащ желания час.

## Кодове за грешка:

5 Невалидно извикване на процедура

13 Несъответствие на типовете

## Пример:

    Sub ExampleTimerValue

    Dim daDT As Date

    Dim a1, b1, c1, a2, b2, c2 As String

        a1 = "начален час"

        b1 = "краен час"

        c1 = "общо време"

        a2 = "8:34"

        b2 = "18:12"

        daDT = TimeValue(b2) - TimeValue(a2)

        c2 = a1 & ": " & a2 & chr(13)

        c2 = c2 & b1 & ": " & b2 & chr(13)

        c2 = c2 & c1 & ": " & trim(Str(Hour(daDT))) & ":" & trim(Str(Minute(daDT))) & ":" & trim(Str(Second(daDT)))

        MsgBox c2

    End Sub