Please enable JavaScript to view this site.

XStudio 3

Navigation: Reference > Task Reference > Start Play Task

Using Cart Macro Characters

Scroll Prev Top Next More

To use cart number macro characters, enter the appropriate macro as a part of the cart number.

Supported Cart Number Macro Characters

Macro

Usage

##

Current Voice Number (2-character string)

Whenever these characters are encountered in a cart number, they are replaced by the current global Voice Number value.

Note: You must always use two characters for defining a voice number and always use the ## (pound sign, pound sign) designation when entering the Current Voice Number macro.

%

Current Day of Week (1=Monday .. 7=Sunday)

This character is replaced by the numeric value for the current day of the week.

^

Current Hour (12-hour format)

Hours 1 through 9 = 1..9, 10 = A, 11 = B, 12 = C

Note: Because this is a 12-hour format, the current hour value used when substituting for this macro character can occur twice during the day. For instance the 10 AM and 10 PM hours will return the same value - "A".

@

Nearest Hour (12-hour format)

If current minute of the hour >= 30, then the returned hour value is incremented by 1.

Note: Because this is a 12-hour format, the current hour value used when substituting for this macro character can occur twice during the day. For instance the 10 AM and 10 PM hours will return the same value - "A".

=

Current Hour (24-hour format)

Hours 0 (midnight) through 9 = 0..9, 10 = A, 11 = B, 12 (noon) = C, 13 (1 PM) = D through 23 (11 PM) = N

Using this macro character format, there are no duplicates throughout the day.

+

Nearest Hour (24-hour format)

If current minute of the hour >= 30, then the returned hour value is incremented by 1.

Hours 0 (midnight) through 9 = 0..9, 10 = A, 11 = B, 12 (noon) = C, 13 (1 PM) = D through 23 (11 PM) = N

Using this macro character format, there are no duplicates throughout the day.

Day of Week Values

The day of week macro character returns a numeric value, based on the current day of the week. Values returned are shown in this table.

Day

Value

Monday

1

Tuesday

2

Wednesday

3

Thursday

4

Friday

5

Saturday

6

Sunday

7

Hour of Day Values

Hour of Day macro characters will return different one-character values, depending on the specific macro character used. The main differences occur between any 12-hour format and any 24-hour format. Values returned by each format type are listed in this table.

Hour of Day

12-Hour Format

24-Hour Format

Midnight

C

0

1 AM

1

1

2 AM

2

2

3 AM

3

3

4 AM

4

4

5 AM

5

5

6 AM

6

6

7 AM

7

7

8 AM

8

8

9 AM

9

9

10 AM

A

A

11 AM

B

B

Noon

C

C

1 PM

1

D

2 PM

2

E

3 PM

3

F

4 PM

4

G

5 PM

5

H

6 PM

6

I

7 PM

7

J

8 PM

8

K

9 PM

9

L

10 PM

A

M

11 PM

B

N