Функції заміни та заміни

Застосовується до: стовпців Dataverse формул програм Canvas Потоків робочого столу Програм, Power Platform керованих моделлю, CLI

Заміна частини текстового рядка на інший рядок.

Опис

У функції Replace текст, який потрібно замінити, визначається початковою позицією та довжиною.

Функція Substitute визначає текст, який потрібно замінити, порівнюючи його з відповідним рядком. Якщо знайдено більше однієї відповідності, можна замінити їх усі або вказати для заміни одну з них.

Якщо передати один рядок, то повернуте значення буде зміненим рядком. Якщо передати таблицю з одним стовпцем, яка містить рядки, поверненим значенням буде таблиця з одним стовпцем зі стовпцем «Значення» змінених рядків. Якщо ваша таблиця має кілька стовпців, ви можете переробити її на таблицю з одним стовпцем, як описано в розділі Робота з таблицями.

Синтаксис

Replace( String, StartingPosition, NumberOfCharacters, NewString )

• String — обов'язковий аргумент. Рядок для роботи.
• StartingPosition — обов’язковий аргумент. Розташування символу, з якого потрібно почати заміну. Перший символ рядка має розташування 1.
• NumberOfCharacters — обов’язковий аргумент. Кількість символів, які потрібно замінити в рядку.
• NewString — обов’язковий аргумент. Рядок на заміну. Кількість символів у цьому аргументі може відрізнятись від аргументу NumberOfCharacters.

Substitute( String, OldString, NewString [, InstanceNumber ] )

• String — обов'язковий аргумент. Рядок для роботи.
• OldString — обов’язковий аргумент. Рядок, який потрібно замінити.
• NewString — обов’язковий аргумент. Рядок на заміну. OldString і NewString можуть мати різну довжину.
• InstanceNumber — необов’язковий аргумент. Використовуйте цей аргумент, щоб указати, який екземпляр OldString потрібно замінити, якщо рядок містить більше одного екземпляра. Якщо цей аргумент не вказано, буде замінено всі екземпляри.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

• SingleColumnTable — обов’язковий аргумент. Таблиця з одним стовпцем, що містить рядки, для яких потрібно виконати операцію.
• StartingPosition — обов’язковий аргумент. Розташування символу, з якого потрібно почати заміну. Перший символ кожного рядка в таблиці має розташування 1.
• NumberOfCharacters — обов’язковий аргумент. Кількість символів, які потрібно замінити в кожному рядку.
• NewString — обов’язковий аргумент. Рядок на заміну. Кількість символів у цьому аргументі може відрізнятись від аргументу NumberOfCharacters.

Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )

• SingleColumnTable — обов’язковий аргумент. Таблиця з одним стовпцем, що містить рядки, для яких потрібно виконати операцію.
• OldString — обов’язковий аргумент. Рядок, який потрібно замінити.
• NewString — обов’язковий аргумент. Рядок на заміну. OldString і NewString можуть мати різну довжину.
• InstanceNumber — необов’язковий аргумент. Використовуйте цей аргумент, щоб указати, який екземпляр OldString потрібно замінити, якщо рядок містить більше одного екземпляра. Якщо цей аргумент не вказано, буде замінено всі екземпляри.

Приклади

Формула	Опис	Результат
Replace( "abcdefghijk", 6, 5, "*" )	Замінює п’ять символів у «abcdefghijk» на один символ «*», починаючи з шостого символу («f»).	«abcde*k»
Replace( "2019", 3, 2, "20" )	Замінює останні два символи «2019» на «20».	«2020»
Replace( "123456", 1, 3, "_" )	Замінює перші три символи «123456» на один символ «_».	«_456»
Substitute( "Sales Data", "Sales", "Cost" )	Заміняє рядок «Вартість» на «Збут».	«Відомості про вартість»
Substitute( "Quarter 1, 2018", "1", "2", 1 )	Замінює лише перший екземпляр «1» на «2», оскільки четвертий аргумент (InstanceNumber) має значення «1».	«Квартал 2, 2018»
Substitute( "Quarter 1, 2011", "1", "2", 3 )	Замінює лише третій екземпляр «1» на «2», оскільки четвертий аргумент (InstanceNumber) має значення «3».	«Квартал 1, 2012»
Substitute( "Quarter 1, 2011", "1", "2" )	Замінює всі екземпляри «1» на «2», оскільки четвертого аргументу (InstanceNumber) немає.	«Квартал 2, 2022»
Replace( [ "Quarter 1, 2018", "Quarter 2, 2011", "Quarter 4, 2019" ], 9, 1, "3" )	Замінює дев’ятий символ у кожному записі таблиці з одним стовпцем зі значенням «3».	Таблиця з одним стовпцем зі Value стовпцем, що містить такі значення: [ "3 квартал 2018 р.", «Квартал3,2011», "Quarter 3, 2019" ]
Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3", 1 )	Оскільки четвертий аргумент (InstanceNumber) надається зі значенням «1», він замінює лише перший екземпляр «1» у кожному записі таблиці з одним стовпцем зі значенням «3».	Таблиця з одним стовпцем зі Value стовпцем, що містить такі значення: [ "Qtr 3, 2018", «Квартал3,2011», «Кв. 3,2019»]
Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3" )	Оскільки четвертий аргумент (InstanceNumber) не надається, він замінює всі екземпляри «1» у кожному записі таблиці з одним стовпцем зі значенням «3».	Таблиця з одним стовпцем зі Value стовпцем, що містить такі значення: [ "Qtr 3, 2038", "Quarter 3, 2033", «Кв. 3,2039»]